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WARNING: 





This equipment generates, uses, and can 
radiate radio frequency energy and if 
not installed and used in accordance 
with the instructions manual, may cause 
interference to radio communications. 
It has been tested and found to comply 
with the limits for a class A computing 
device pursuant to subpart J of Part 15 
of FCC Rules, which are designed to 
provide reasonable protection against 
such interference when operated ina 
commercial environment. Operation of 
this equipment in a residential area is 
likely to cause interference, in which 
case the user, at his own expense, will 
be required to take whatever measures 
may be required to correct the 
interference. 
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Preface 


What is IRMA 3279 Graphics? 


IRMA 3279 Graphics is a hardware/software 
product that brings IBM 3279 S3G color graphics 
to your IBM Personal Computer (PC), PC XT, or 
PC AT. IRMA 3279 Graphics provides all the 
functions of the 3279 S3G terminal plus extended 
functions that let you save, redisplay, and print 
host graphics from the PC without reconnecting to 
the host. You can even perform high-speed file 
transfers with complimentary IRMAlink file 
transfer software. And the IRMA 3279 Graphics 
hardware is completely compatible with IRMA’s 
E78 emulator, so you_can run a variety of software 
such as TempusLink,!M Interactive PC Link, 
LOTUS 1-2-3, 1M and Microsoft Word.1M 


IRMA 3279 Graphics is available in two forms: a 
complete emulation and graphics hardware 
assembly, and an upgrade hardware assembly that 
attaches to an IRMA card installed in your PC. 
While both the upgrade and the complete IRMA 
3279 Graphics product provide the same functions 
and features, the hardware and software cannot be 
mixed. 
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Product Features 


IRMA 3279 Graphics and the upgrade provide the 
following features: 


1) Complete emulation of the IBM 3279 S3G 
graphics terminal with program symbols 


0 Extended capabilities for storing, printing, 
and redisplaying graphics while online with 
the host 

Oo Special utilities for printing and redisplaying 


graphics offline from the host 

) Support for extended color and highlighting 
and for EBCDIC, APL, scientific notation, 
and foreign language fonts 

0 High-speed file transfer capability with 
complimentary IRMAIlink FT/TSO and 
FT/CMS file transfer software 

Oo Compatibility with DCA’s IRMAIlink 
FT/3270 file transfer software, versions 1.27 


and greater and ForteNet I and II file 
transfer software 


0 Complete compatibility with DCA’s E78 
emulation program, versions 1.42 and greater 


0 Hot key switching from DOS to emulation 


Oo Support for the IRMAkey/3270 keyboard and 
the IBM Enhanced keyboards 


0 Emulation of three 3279 keyboards 
0 Configurable keyboard with macro capability 


Oo Compatibility with the AT&T 6300/Olivetti 
M24 computer 
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0 IBM Selector Light pen support when the E78 
emulator is used with the IBM Color 
Graphics Adapter (CGA) or Enhanced 
Graphics Adapter (EGA). The GRAPH 
emulator does not provide light pen support. 


What to Do First 





Checking Package Contents 


The IRMA 3279 Graphics hardware is available in 
two forms, as a combined graphics-emulation 
product or as a graphics hardware upgrade for an 
IRMA board. The upgrade has a top connector 
that distinguishes it from the IRMA 3279 Graphics 
hardware. Check your package to be sure you 
have the right hardware. Also check your package 
to be sure it contains the following items: 


Oo IRMA 3279 Graphics diskette 
oO IRMA 3279 Graphics User’s Guide 
O Keyboard Utilities diskette 


0 3 standard PC keyboard templates and 3 
enhanced keyboard templates 


Oo plastic card guide 


ry video cable 
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oO IRMAIink FT/TSO and FT/CMS file transfer 
diskette 


oO IRMAIipk FT/CMS and FT/TSO User’s 
Manual 


* The IRMAlink file transfer software and 
documentation are included as part of the IRMA 
package, so they are not included in the IRMA 
3279 Graphics upgrade package. If you need a 
copy of the IRMAlink software or documentation, 
contact DCA Customer Support. In Georgia, call 1- 
404-442-4470. Outside Georgia, call 1-800-631- 
4171. 


If any item is missing, contact your IRMA 
distributor. 


Validating the Warranty 


Now turn to the Customer Support section located 
at the end of this guide and carefully read the 
warranty information. Complete the product 
registration card included with your package and 
return it to DCA. This card validates your IRMA 
3279 Graphics product warranty and provides a 
way to keep you informed of any updates that 
occur. 


Guide Contents 


This guide provides complete instructions for 
installing, configuring, and using IRMA 3279 
Graphics and the graphics upgrade. This guide 
does not discuss details about data communications 
concepts, host graphics programs, host operations 
and application programs, or IBM 3270 terminal 
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operations. If you need information about these 
topics, refer to your system supervisor or the 
following IBM publications: 


For information about 3270 terminals: 
IBM 3270 Information Display System Configuration, 
GA27-2849. 


For information concerning 3279 keyboards: 
IBM 3270 Information Display System Character Set 
Re ference, GA27-2837-6. 


For information about a particular host graphics 
program, see the appropriate program 
documentation. 


Organization 


This user’s guide is divided into the following 
chapters: 


Chapter 1, "Installation and Setup," gives 
instructions for installing the IRMA 3279 Graphics 
hardware and the upgrade hardware. This chapter 
also includes instructions for setting the various 
jumpers on the hardware. See Appendix H for 
instructions on installing the hardware in an 
AT&T 6300/Olivetti M24 computer. 


Chapter 2, "Software Configuration," describes the 
"GraphPac" configuration utility that lets you 
specify the type of display, printer, and keyboard 
you are using. 


Chapter 3, "S3G Terminal Emulation and 
Operation," shows how to operate the 3279 S3G 
terminal emulation program, GRAPH.EXE. 


Chapter 4, "Extended Functions," explains how to 
use the special capabilities of IRMA 3279 Graphics 
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to save, print, and redisplay host text and graphics 
locally at the PC, while online with the host as 
well as offline. 


Chapter 5, "E78 Emulation," shows how to 
customize the E78 emulation program to run on 
the IRMA 3279 Graphics hardware. 


Chapter 6, "Using the Keyboard Macro Driver, 
KMACDRV.SYS," explains how to use the 
<Alt><+> capability of the macro driver to create 
key macro files. 


Chapter 7, "Remapping the Keyboard," shows how 
to use the KYBDEDIT program to remap the 
keyboard by altering, exchanging, and copying key 
codes. A good working knowledge of the IBM 
BIOS routine is required to use KYBDEDIT. 


Appendix A, "Keyboards and Keys," presents 

reference tables and diagrams that describe 3279 
keyboards, keys, and functions, and shows where 
3279 functions are assigned on the PC keyboard. 


Appendix B, "Status Line Symbols and Messages," 
contains tables that list the symbols and messages 
that may display on the status line while you use 
IRMA 3279 Graphics. 


Appendix C, "Error Messages," lists and explains 
the error messages that may appear during any 
phase of IRMA 3279 Graphics operation. 
Instructions for correcting each error are included. 


Appendix D, "Glossary," defines technical terms 
and words used frequently in this user’s guide. 


Appendix E, "Diagnostics," discusses the "CHKBD" 
program that allows you to test the installation of 
the emulator and graphics boards. 
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Appendix F, "Advanced Utilities," provides 
experienced users with instructions for using 
GraphPac to remap 3279 keys on the PC keyboard. 


Appendix G, "Controller and Mainframe 
Configuration,” gives the system programmer some 
notes to use when configuring the mainframe 
computer and the controller for use with IRMA 
3279 Graphics. 


Appendix H, "AT&T Installation Guide,” provides 
special installation instructions for AT&T 6300 
and Olivetti M24 users. 


Customer Support Information provides warranty 
information, copyright restrictions, and explains 
what you should do if you need to return your 
hardware for repair. 
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Conventions Used in This Guide 





Frequently-Used Terms 


Throughout this guide, the following terms are 
used: 


o Upgrade refers to the IRMA 3279 Graphics 
upgrade hardware that connects to an existing 
IRMA board. 


o The term IRMA 3279 Graphics refers to the 
IRMA 3279 Graphics product as a whole, 
including the upgrade. 


o Emulator refers to the GRAPH emulation 
program unless "E78 emulator" is specified. 


o Emulation refers to IRMA 3279 Graphics’ 
functioning as a terminal. 


o The mainframe computer is called the host. 
o Communication with the host is called a session. 


o When the term enter is used as part of an 
instruction (such as "Enter the filename") you 
must type the required filename, command, or 
other data, then press the <Enter> key. (The 
<Enter> key is also known as the carriage 
return key or the <4 key. When using the 
IRMAkey keyboard in a 3270 session, be sure to 
use the key marked "Enter.") 
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Typographical Conventions 


upper/ You can type commands in either 
lower- uppercase or lowercase letters, 

case according to your preference. 
italics Italicized words signify the type of 


information requested by a command. 
Do not type the italicized word or 
letter. Instead, read the command 
description to see what information 1s 
requested. 


< > Angle brackets appear around keys on 
the PC keyboard, e.g. <Esc>, <Enter>, 
<F3>, <a>. Press the key indicated by 
the angle brackets. Do not type the 
brackets. 


[ ] Square brackets appear around options 
in a command line, e.g. 


GRAPH [-r] 
To use the option, type the information 


inside the brackets. Do not type the 
brackets. 
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Chapter 1 


Installation and Setup 


Introduction 


This chapter provides information to help you sct 
up your system to run IRMA 3279 Graphics. The 
first part of the chapter provides system 
requirements and a checklist of installation steps. 
The last part of the chapter shows how to set the 
hardware jumpers and install the board in your 
PC. (If you are installing the hardware in an 
AT&T 6300 or Olivetti M24 computer, read the 
first half of this chapter. Then go to Appendix H 
for specific installation instructions.) 


System Requirements 


The following items are required to run IRMA 
3279 Graphics. 


Item Description 
personal computer o IBM PC, PC XT, PC AT 


Or 
o0 AT&T 6300/Olivetti M24 


memory o 128 Kilobytes Random 
Access Memory (RAM) 
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disk drive o at least 1 floppy disk 
drive with 320 Kbytes 
capacity 

DOS o IBM PC DOS 


o Versions 2.1, 3.1, or 3.2 


graphics hardware o Color Graphics Adapter 
(CGA) or Enhanced 
Graphics Adapter (EGA) 


color monitor o High-resolution, long 
persistence, phosphor 
monitor capable of 2:1 
interlace 


The following monitors are supported: 


o Amdek Color 710 o Microvitec 14L86 DD2U 
o IBM 5153 o IBM 5154 Enhanced Color 
o PGS HX-12LP o0 JVC GD-HIOI14LP 
o Zenith ZVM-136 o Electrohome ECM-1301 
0 AT&T 6300/ o Aydin Controls 8810LP 
Olivetti M24 0 NEC MULTISYNC with 
CGA 
0 NEC MULTISYNC with 
EGA 
printer (optional) o serial or parallel non- 


graphics printer 


o color or black and white 
graphics printer 


The following color graphics printers are 
supported: 
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IBM 5182 o Quadram Quadjet 
IBM 3852 o Tandy CGP-220 
Toshiba P351C o Canon PJ1080A 
Advanced Color Technology (ACT IIT) 


oo 0 0 


The following black and white graphics printers 
are supported: 


o Toshiba P351 o GTC Blaser 
o Epson FX80 o HP LaserJet 
host software Host and application 


software configured to 
expect an IBM 3279 Model 
S3G terminal on the 
communication line and port 
where the PC is attached 
(see Appendix G) 


o IRMAIlink host code is 
required for IRMAlink 
file transfer; see 
IRMAIlink User’s Manual. 


network o connection to an IBM 
connection 3174 or 3274 terminal 
controller 


o C, D, or T support 


(IBM 3276 terminal controllers do not support 
IRMA 3279 Graphics or IBM Model S3G terminals 


using Programmed Symbols and extended data 
streams.) 
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Getting Started 





Use the following checklist to get IRMA 3279 
Graphics installed and running. Check off each 
item to confirm that it has been completed. 


Function to Perform Completed 


1) Read the warranty information 
(Customer Support section). 
Complete and mail the product 
registration card (inside back 
cover). 


2) Set the Jl] jumper on the board 
(Chapter 1). 


3) Set the JP1 and JP2 jumpers if 
necessary (Chapter 1). 


4) Install the hardware (Chapter 1 - 
IBM computers, Appendix H - AT&T 
6300 computers). 


5) Install the software (Chapter 2). 
6) Use GraphPac to specify the 

type of printer and monitor 

you are using, and to specify 

any other options (Chapter 2). 
7) Create or edit a CONFIGSYS file 


to hold the keyboard drivers 
(Chapter 2). 


8) Reboot the PC to load the keyboard 
drivers (Chapters 2, 6, and 7). 


9) Verify that your controller 
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is set up to run with a 3279 
S3G graphics terminal by using 
the TEST function (Chapter 2). 


10) Review the 3279 keyboard layouts 
in Appendix A, if necessary. 


11) Customize E78 if you plan to run 
that emulator on the IRMA 3279 
Graphics hardware (Chapter 5). 


12) Start emulation (Chapter 3). 


Hardware Installation 





The hardware installation instructions in this 
chapter are intended for IBM PC, XT, and AT 
users. If you are installing IRMA 3279 Graphics 
hardware in an AT&T 6300 or Olivetti M24 
computer, refer to Appendix H for special 
installation instructions. The following sections 
describe how to set the jumpers that define the 
monitor and the hardware base address. The last 
two sections show how to install the hardware in 
your PC. 


Setting the J1 Jumper 


A jumper is a pin-like structure located on the 
printed circuit board. Both the upgrade and the 
original IRMA 3279 Graphics boards have a 
jumper labelled J1, which sets the board for the 
type of monitor you are using. Locate the J1 
jumper using the following diagram: 
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Ji JUMPER 


~ 
o, 


N 


N 
S53 
/ 





Figure 1-1: J1 Jumper Location 
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If you are using an IBM EGA (Enhanced Graphic 
Adapter) monitor or an equivalent monitor, set the 
jumper like this: 


“I JQ. 0 


Figure 1-2: J1 Jumper Setting for an IBM EGA 


If you are using any other monitor, set the jumper 
as shown below: 





Figure 1-3: J1 Jumper Setting for Non-EGAs 


If you have the upgrade hardware, skip the next 
section and read the section entitled, "Installing 
the Hardware in an IBM Computer." 
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Setting the Base Address Jumpers 


(This section does not apply to the upgrade 
hardware, as its base address is defined by the 
IRMA board. IRMA’s address of 220 cannot be 
changed. Change the address of any other board 
in your PC that conflicts with IRMA.) 


The default hardware base address for IRMA 3279 
Graphics is 280. If the default address of 280 
conflicts with the address of another board in 
your PC, you need to change the JP1 and JP2 
jumper settings. The following diagram shows the 
location of the jumpers, as well as the possible 
jumper settings and their base addresses. Use this 
diagram and the following information to set a 
base address not used by another board in your 


PC: 

Figure 1-4 Base 

Diagram Address Jumper Setting 

A 300 JP1 at 2 
JP2 at 2 

B 2A0 JPl at 2 
JP2 at 1 

Cc 2C0 JPi at 1 
JP2 at 2 

D 280 JP1i at 1 
JP2 at 1 


NOTE: JP3 must always be set at 1. 


If you change the base address jumpers, you must 
set the same address in the software using the 
GraphPac configuration program, see Chapter 2. 
Note that the E78 emulator ignores these jumpers 
settings. 





Chapter 1 - Installation and Setup 





Figure 1-4: Base Address Jumper Settings 
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Installing the Hardware 
in an IBM Computer 


Perform these steps to install the IRMA 3279 
Graphics hardware in your IBM computer. If you 
need to install the upgrade hardware, follow steps 
1 through 8, then complete the instructions in the 
next section. If you are using an AT&T 6300 or 
Olivetti M24 computer, refer to Appendix H for 
special installation instructions. 


STEP 1: Turn the PC power OFF and disconnect 
the power cord from the electrical 
outlet. Then disconnect the power cord 
from the rear panel of the PC. 


SPEP 2: Turn OFF all externally attached 
devices such as printers, modems, etc. 
Unplug the power cables from the 
electrical outlets. 


STEP 3: Remove all cables from the back of the 
system unit, noting the location of each 
cable. 


STEP 4: If you are using an IBM PC AT, turn 
the key on the front panel 
counterclockwise to the unlocked 
position. Use your fingers or a flat- 
blade screwdriver to carefully remove 
the plastic back panel cover attached 
with hook-and-loop fasteners. 
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STEP 5: Using a PC or PC XT, remove the five 
cover mounting screws from the outside 
of the rear panel. 




















STEP 6: Carefully slide the cover forward and 
remove it. 





—= CHASSIS 
; ee ye 
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NOTE: We recommend that you install the 
IRMA 3279 Graphics hardware in the 
outer expansion slot, placing your Color 
Graphics Adapter (CGA) or Enhanced 
Graphics Adapter (EGA) in a slot no 
more than five inches away. Leave at 
least one slot between IRMA 3279 
Graphics and the display adapter. Do 
not install IRMA 3279 Graphics next to 
the disk controller on the IBM PC AT. 


STEP 7: Remove the necessary expansion slot 
covers and screws. Save the screws for 











later use. 
EXPANSION SLOT COVER @ EXPANSION SLOT SCREW 
I 
ry a 
23,2 
i aa Sayyed ea 
y f aa ff — f—=/ ee 
EXPANSION SLOT —— | | | 
|| 
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STEP 8: If you are using the IBM PC or PC XT, 
insert the plastic card guide into the 
holes that correspond to the expansion 
slot where you will install IRMA 3279 
Graphics (or the display adapter if a 
card guide is already in the IRMA 3279 
Graphics slot). 





(If you are installing the upgrade, go to the next 
section.) 
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STEP 9: Grasp the IRMA 3279 Graphics board 
assembly by the top or sides and guide 
it into the proper slot, being sure that 
the pins at its base fit into the 
connector in the expansion slot. Press 
firmly. Check to see that the front 
edge is in the card guide and the 
coaxial connector bracket is properly 
positioned in the rear panel. The top 
Should be even with all other cards. 


IRMA 3279 GRAPHICS BOARD 
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STEP 10: Secure the board with the screw you 
removed in step 10. 


| SCREW TO SECURE BOARD 
¥ 
{ 
oe t 
IRMA 3279 GRAPHICS BOARD = ene 





STEP 11: Replace the system unit cover by 
sliding it back over the chassis. Check 
to see that the lip (located on the 
bottom of the cover sides) fits under 
the rail on the sides of the chassis. 


STEP 12: If you have an IBM PC AT, replace the 
back panel cover. 


STEP 13: Replace the screws that secure the 
cover. 
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STEP 14: 


STEP 15: 


Connect the coax cable (not provided) 
from your communications controller to 
the round, bottom socket of the 
emulator board. Rotate the connector 
until it locks into place. 





| i 
i. . , 
hs | 
al ‘ 
D> ; 
iby 
~~ th 
| : 
{, Gy 
: of \ 
| art 
S74 
{ 


ieee \\ COAX CABLE 


A short video cable is supplied with 
your IRMA 3279 Graphics package. 
Connect the female end of this cable to 
the male socket in the center of the 
emulator board. 


CONNECTOR 
IRMA 3279 GRAPHICS BOARD 


























VIDEO CABLE 
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STEP 16: Connect the male end of the vidco 
cable to the female socket on the CGA 
or EGA card. 


CONNECTOR 
DISPLAY ADAPTER 


VIDEO CABLE 





STEP 17: Connect the male end of the cable from 
your display unit to the female socket 
at the top of the emulator board. 


CONNECTOR 
IRMA 3279 GRAPHICS BOARD 





DISPLAY ADAPTER CABLE 











STEP 18: Test the installation using the 
diagnostic program in Appendix E. 
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Installing the Upgrade Board 


After finishing steps | through 8 in the previous 
section, perform the following steps to complete 
the IRMA 3279 Graphics upgrade installation. 


STEP 9: To promote cooling, install the graphics 
upgrade board in the outer expansion 
slot of your PC and position IRMA in 
the adjacent slot, removing the display 
adapter if necessary. Fit the pins of 
the boards into the base connectors of 
the expansion slots and press firmly. 


IRMA 3279 GRAPHICS UPGRADE BOARD 
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NOTE: We recommend that you do not install 
the upgrade hardware next to the disk 
controller on an IBM PC AT. 


STEP 10: Replace the retaining screws to secure 
the boards to the PC frame. 


STEP 11: Connect the graphics upgrade board to 
IRMA as shown in the following 
diagram. Position the 60-pin connector 
of the upgrade board over the top 
connector of the IRMA board. Push 
down on the connector so that it is 
mounted securely on the IRMA board. 


~ 60-PIN CONNECTOR IRMA 3279 GRAPHICS UPGRADE BOARD 





Seals 
ATs 


IRMA 








— 
RS 
SOs ~ 
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STEP 12: 


STEP 13: 


If you removed the display adapter, re- 
install it in a slot no more than five 
inches away from the upgrade 
hardware. Leave at least one slot 
between a double-board display adapter 
(such as the IBM EGA) and IRMA 3279 
Graphics. (You can install a single 
board or a half slot board in the slot 
between the upgrade and the display 
adapter.) 


Replace the system unit cover by 
Sliding it back over the chassis. Check 
to see that the lip (located on the 
bottom of the cover sides) fits under 
the rail on the sides of the chassis. 


If you have an IBM PC AT, replace the 
back panel cover. 
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STEP 14: Replace the screws that secure the 
cover. 


STEP 15: Connect the coax cable to your IRMA 
board. 


STEP 16: If you have not done so already, 
remove the cable from the color 
graphics adapter or EGA. Insert the 
cable into the female top socket of the 
upgrade board. 


DISPLAY ADAPTER 





IRMA BOARD 
CONNECTOR 
—/F IRMA 3279 GRAPHICS UPGRADE BOARD 
Lp DISPLAY ADAPTER CABLE 





STEP 17: A short video cable is supplied with 
your IRMA 3279 Graphics package. 
Connect the female end of the cable to 
the male middle socket on the upgrade 
board. 


~~ DISPLAY ADAPTER 














VIDEO CABLE 


CONNECTOR 
‘ IRMA BOARD IRMA 3279 GRAPHICS UPGRADE BOARD 
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STEP 18: Connect the male end of the video 
cable to the female socket on the CGA 
or EGA. 


f IRMA BOARD 
ee 


—~_ [~~ IRMA 3279 GRAPHICS UPGRADE BOARD 





VIDEO CABLE 





CONNECTOR 
DISPLAY ADAPTER 


STEP 19: Check the installation using the 
diagnostic program in Appendix E. 
Note that the first part of this program 
tests the IRMA board, and the second 
part tests the 3279 S3G emulator board. 
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Software Configuration 


Introduction 


Before you can use your PC as a 3279 S3G 
graphics terminal, you must install the software 
and run the GraphPac configuration program. The 
first half of this chapter provides instructions for 
installing the software on floppy disks and on a 
hard disk. The second half describes the 
GraphPac configuration program. 


Installing the Software on Floppy Diskettes 


You will need two formatted diskettes on which to 
install the software. Put DOS on one of the 
diskettes. Follow these steps to complete the 
installation: 


STEP 1: Put the IRMA 3279 Graphics Program 
diskette in drive A. Put the diskette 
formatted without DOS in drive B. 


STEP 2: At the DOS prompt, type the following 
command to copy the program files to 
drive b: 


copy *.* b: 


You now have a copy of the Program 
diskette in drive B. Put the original 

diskette in a place where it won’t get 
damaged. 
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STEP 3: 


STEP 4: 


STEP 5: 


STEP 6: 


Replace the diskette in drive B with the 
diskette formatted with DOS. Replace 
the program diskette in drive A with 
the Keyboard Utilities diskette. 


Copy the keyboard utilities to drive B 
by typing: 


copy *.* b: 


Now you have a bootable copy of the 
Keyboard Utilities diskette in drive B. 
Put the original diskette in a place 
where it won’t get damaged. 


From this point on, use the diskette 
copies for all operations. 


Put the bootable Keyboard Utilities 
diskette in drive A and the copy of the 
Program diskette in drive B. 


Create a CONFIGSYS file on the 
Keyboard Utilities diskette to contain 
the keyboard drivers. Type the 
following command at the DOS A> 
prompt: 


COPY CON CONFIG.SYS <Enter> 
DEVICE=KYBDDRV.SYS -2[X] <Enter> 
DEVICE=KMACDRV.SYS <Enter> 
<F6> <Enter> 


The -2 in the second line allows space in memory 
for two keyboard profiles. You can allow memory 
for up to 9 keyboard profiles. 


The X option represents one or all of the following 


values: 
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for X Action 


A Turns OFF PrtSc 

B Turns OFF key click 

C Turns OFF shift toggle 

D Turns ON one-finger shift mode 

F Turns OFF automatic key repeat 

G Forces to a 15-key buffer 

1 Implements IRMAkey keyboard 

j Implements AT&T 6300/Olivetti 
M24 keyboard 


Include the switches you want to use after the -2, 
e.g. DEVICE=KYBDDRV.SYS -2ACFi. All users 
must include the -2 switch. [RMAkey users must 
specify i. AT&T 6300/Olivetti M24 users must 
specify j. These switches are described in greater 
detail in the following section. 


SCEP 7: Reboot the PC to load the keyboard 
drivers. 


Note that the bootable copy of the Keyboard Utilities 
diskette must always be in drive B when you boot the 
PC in order for the keyboard drivers to load. 


STEP 8: Read the section, "Do I Need to Use 
GraphPac," and run that configuration 
program if necessary. 


STEP 9: If you plan to use attribute-select keys 
and program symbol sets, read the 
section at the end of this chapter, 
entitled "Selecting Attributes and 
Program Symbol Sets," for some special 
instructions. 


After completing these steps, you are ready for 
emulation. 
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Using Keyboard Switches 





The KYBDDRV.SYS driver provides several 
keyboard features, most of which can be activated 
in one of two ways: 


o By including a "switch" with the 
KYBDDRVSSYS driver in the CONFIGSYS file 
(activates the feature for all keyboard profiles), 


o By pressing a key sequence -- where available 
(activates the feature only for the currently 
active profile) 


To deactivate a feature, you either remove the 
Switch or press the key sequence again. 


The following paragraphs list and describe the 
Switches and key sequences that activate the 
keyboard driver features. Keys represented by 
<NP> are located on the Numeric Key Pad. The 
format for including a switch as part of the 
KYBDDRV.SYS line is shown in the installation 
sections of this chapter. 


Switch Function Key Sequence 
1-9 Allocates not available 
memory for 
profiles 


REQUIRED: Allows memory for up to 9 keyboard 
profiles; you must specify at least 2. Each profile 
requires 3K of RAM. See Chapter 7 to create 
alternate keyboard profiles. 


A Turns OFF <Ctrl><Alt><PrtSc> 
PrtSc 
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OPTIONAL: Changes the state of the PrtSc enable 
switch on the numeric key pad. When PrtEn (print 
enable) is OFF, <Shift><PrtSc> has no effect. 


B Turns OFF <Ctrl><AIt><NP7> 
key click 


OPTIONAL: Disables the key click function. 


6 Turns OFF <Ctrl><Alt><NP8> 
shift toggle 


OPTIONAL: Changes the action of the shift key 


when CAPS LOCK is ON. Normally, the shift of a 
key produces the lower case key when CAPS LOCK 
is ON. When you use this option, however, the shift 
of a key produces the upper case key when CAPS 
LOCK is ON. 


D Turns ON the = <Ctrl><AIt><NP9> 
one-finger 
shift mode 


OPTIONAL: Prevents the need to hold the shift key 
while pressing the key to be shifted. When this mode 
is ON, you can press the shift key, release it, and the 
next key pressed transmits a shifted value. The next 
key pressed turns off the shifted function. To 
release accidentally pressed shift keys, press the 
CAPS LOCK key twice. 


F Turns OFF <Ctrl><Alt><NP4> 
automatic 
key repeat 


OPTIONAL: Turns OFF the automatic key repeat, 
which is active when you hold a key for more than 
half a second 


G Forces to a not available 
15-key buffer 
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OPTIONAL: Reverts from the 128-key buffer 
provided by the keyboard driver to the standard 15- 
key buffer. You may need to include this switch 
when using certain PC application programs or when 
using a PC mouse. 


i Implements not available 
IRMAkey 
keyboard 


REQUIRED when an IRMAkey keyboard is attached 
to the PC. 


j Implements not available 
AT&T 6300/ 
Olivetti M24 
keyboards 


REQUIRED when an AT&T 6300/Olivetti M24 
keyboard is attached to the PC. 


Installing the Software on a Hard Disk 





Installing the IRMA 3279 Graphics software on a 
hard disk is a procedure made simple by the use of 
the DCA.BAT file. This file creates a directory 
labelled \DCA, installs all files into this directory, 
prompts you for RPQ keyboard configuration, and 
executes the GraphPac configuration program. The 
following steps show how to use DCA.BAT and give 
directions for installing keyboard drivers. Read 
these steps carefully before beginning your 
installation. 


NOTE: If you are configuring an RPQ keyboard, 
the RPQ file must be located in the same 
directory as DCA.BAT. Otherwise, the 
program will not find the keyboard data 
file and configuration will not take place, 


aa: 


STEP 1: 


STEP 2: 


STEP 3: 
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even though a "configuration complete" 
message may display. The international 
keyboard option that comes up with the 
RPQ keyboard option is valid only for 

international users. 


Put the program diskette in drive A 
and type: 


DCA C: <Enter> 


This command starts DCA.BAT, which 
operates as described in the previous 
paragraph. DCA.BAT installs the 
program files in the \DCA directory on 
the specified drive. 


Follow the directions on the screen to 
move through the DCA.BAT program. 
Most prompts request that you type 
({n]/y) for a response. If there are 
brackets around the response, e.g. [n], 
you can simply press <Enter>. If there 
are no brackets, type the letter and 
press <Enter>. 


Most users need to run the GraphPac 
configuration program, which is fully 
described in this chapter. Refer to the 
section entitled, "Do I Need to Use 
GraphPac?" for details. 


Next, put the keyboard drivers in a 
CONFIG.SYS file on your hard disk to 
be read at boot time. If your hard disk 
already contains a CONFIGSYS file, 
use your editing program to insert the 
last two lines below. Otherwise, type 
the complete command as follows: 
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COPY CON CONFIG.SYS <Enter> 
DEVICE=KYBDDRV.SYS -2[X] <Enter> 
DEVICE=KMACDRV.SYS <Enter> 
<F6> <Enter> 


The -2 in the second line allows space in memory 
for two keyboard profiles. You can allow memory 
for up to 9 keyboard profiles. 


The X option represents one or all of the following 
values: 


Value 
for X Action 


Turns OFF PrtSc 

Turns OFF key click 

Turns OFF shift toggle 

Turns ON one-finger shift mode 
Turns OFF automatic key repeat 
Forces to a 15-key buffer 
Implements IRMAkey keyboard 
Implements AT&T 6300/Olivetti 
M24 keyboard 


Include the switches you want to use after the -2, 
e.g. DEVICE=KYBDDRV.SYS -2ACFi. All users 
must include the -2 switch. IRMAkey users must 
specify i. AT&T 6300/Olivetti M24 users must 
specify j. These switches are described in greater 
detail in the previous section. 


STEP 4: Reboot the PC to load the keyboard 


drivers. Now you are ready to start the 
emulator. 
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Do | Need to Use GraphPac? 





The GraphPac configuration program lets you 
specify the type of printer, display monitor, and 
keyboard that you plan to use with IRMA 3279 
Graphics. GraphPac also lets you change the video 
background color, specify an alternate hardware 
base address, and change 3279 key assignments. 
The items you can configure are listed below with 
their default values. The third column shows 
when you need to use GraphPac. 


ana 
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GraphPac Configuration Chart 


‘Item to Configure Default Value Is Configuration 
Necessary? 
printer model No printer Yes, if you plan 
assigned to use a printer. 


83/84 key PC Yes, if you are 
keyboard 
keyboard type Atrribute Select |IBM Enhanced key- 
Typewriter/APL |board; or if you 
Keyboard want to use an 
alternate 3279 
keyboard. 


display model no display Yes 
assigned 


- 
hardware base 280 
address 


Attribute Select 
Typewriter/APL 
Keyboard 






























No, this is a 
convenience fea- 
ture for IBM 
Enhanced color 
monitors and AT&T 
6300 color 

monitors. 















Yes, if you set 
the jumpers on 
the board toa 
new address 
(upgrade cannot 
be altered). 



























3279 key assignment 
(See Appendix F 
for instructions) 


No. This option 
Should be used 
only by experi- 
enced operators 
when the default 
key assignments | 
are completely 
unsatisfactory 
for a particular 
application. 
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Starting GraphPac 
To start GraphPac from a floppy diskette, put the 
program diskette in a drive and move to that 
drive. At the DOS prompt type: 
GP <Enter> 


A logo and copyright notice display, followed by 
the HOME menu (see the diagram below). 


If you used DCA.BAT to install the software on a 
hard disk, you are automatically prompted to run 
GraphPac. After you respond positively to run the 


program, the GraphPac logo and copyright notice 
display, followed by the HOME menu: 


HOME -GraphPac- 
IRMA 3279 Graphics 
(c) 1987 Digital Communications Associates, Inc 


1 - Print Saved Graph 
2 - Recall Saved Graph 
3 - Configuration 

0 - Exit 

__ Select One 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 
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The first two items on. this menu are extended 
functions that are described in Chapter 4. The 
third item selects the configuration utility. Note 
the menu’s identification banner, "HOME," in the 
top left corner of the screen. 


To start configuration, type "3" and press <Enter>. 


The following configuration menu displays: 


CONFIG -GraphPac- 
IRMA 3279 Graphics 
(c) 1987 Digital Communications Associates, Inc 
1 - Configure Printer 


2 - Configure Keyboard 


3 - Configure Video 


5 - Configure Base Address 


__ - Select One 


ESC -- Previous ENTER -- Process Selection TAB -- Next Field 


Note that the banner "CONFIG" in the left corner 
of the screen identifies this menu as the 
configuration menu. Choose an item to configure 
by typing the number of your selection in the 
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space preceding "Select One." A menu displays for 
the selected item. Instructions for using the new 
menu and all other menus are provided in the 
following section. 


GraphPac Menu Guidelines 


The following notes apply to all GraphPac menus 
and options. 


O 


Menus are arranged in a hierarchy with the 
GraphPac HOME menu at the top. 


The banner in the top left portion of the 
screen identifies the current menu and shows 
the menus from which the current menu was 
derived. For example, if the banner reads 
"CONFIG-PRINT-SERIAL" the current menu 
is the "SERIAL" printer configuration menu. 


When using the GraphPac program, you move 
from the main menu to a submenu, and often 
to other submenus. Use the <Esc> key to 
return to a previous menu. For example, if 
CONFIG-PRINT-SERIAL is the current menu, 
pressing <Esc> returns you to the CONFIG- 
PRINT menu. Pressing <Esc> again returns 
you to the CONFIG menu. Pressing <Esc> 
another time returns you to the HOME menu. 
If you press the <Esc> key from the HOME 
menu, you return to DOS. 


Valid keys to use on GraphPac menus are 
backspace, backtab, Enter, escape, all cursor 
keys, Home, and Tab. (Key descriptions are 
provided in Appendix A.) 


When you exit the GraphPac program, the 
changes you make are written in the 
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GRAPH.DAT file and are effective the next 
time you enter the GRAPH emulator command 
(see Chapter 3). 


o It is necessary to use GraphPac only once, 
unless you need to specify a different type of 
monitor, printer, or keyboard or change or 
add other options. 


o If you run GraphPac more than once, the 
current values write over the existing values. 
(To use more than one configuration, see 
‘Creating Alternate GRAPH.DAT Files’ in this 
chapter.) 


The following sections show how to configure each 
item on the GraphPac HOME menu. 


Configuring Printers 





IRMA 3279 Graphics does not define a default 
printer. If you need to define a printer to use 
with IRMA 3279 Graphics, follow these steps: 


STEP I: Press 1 <Enter> from the CONFIG 
menu. The following printer menu 
displays listing the printer models 
supported by IRMA 3279 Graphics: 
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CONFIG-PRINT 
-GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


00 - No Printer 08 - Canon PJ1080A 
O1 - Serial Non-graphic 09 - Toshiba P351C 

02 - Parallel Non-graphic 10 - Toshiba P1351 

03 - Advanced Color Technology ACT II 11 - Epson FX80 

04 - Quadram Quadjet 12 - GTC Blaser 

05 - IBM 5182 13 - HP LaserJet 


06 - Tandy CGP-220 
07 - IBM 3852 


00 - Select One 


a nel De ne nee ee ce A De Re ee one a he ee Ree Dna ee ee Re ee ee ee ee 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


SEP 2: Find the two-digit number that 
identifies your printer, and type this 
number in the space preceding "Sclect 
One." Press <Enter>. 


A new menu appears that allows you to 
specify control parameters for the 
chosen printer. (Each printer and its 
menu are discussed in the following 
sections.) 
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Printer Menu Guidelines 


Each printer menu selected from the CONFIG- 
PRINT menu displays parameters whose values you 
can define. Observe the following guidelines when 
using the printer menus and changing parameters: 


O 


To display the menu for a specific printer, 
enter the number of the desired printer on the 
CONFIG-PRINT menu. 


Each printer menu lists the valid parameters 
for that printer. The current parameter value 
displays to the left of each parameter with the 
possible values on the right. 


To keep the current settings press the <Esc> 
key. 


To change a setting, tab to the parameter you 
want to change and type the number of the 
new value over the current value. Then press 
<Enter>. . 


Refer to your printer documentation for 
information on parameters and their 
appropriate values. 


The new settings for the parallel and serial 
non-graphic printer selections take effect the 
next time you enter the GRAPH command. 
The settings for all other printer selections 
take effect immediately. 


NOTE: New settings for the serial and parallel 


non-graphic selections become the DOS 
settings for the connected printers. 

These settings override any parameters 
that may have been previously set with 
the MODE command (see the IBM DOS 
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Guide). Your settings remain in ef{cct 
; for all printer activity until you change 
) them again with the MODE command 
or with the printer menu. 


| The following sections discuss each entry on the 
: CONFIG-PRINT menu. 
: Serial Non-Graphics Printers 
= From the CONFIG-PRINT menu, type 01 and press 


<Enter> to display the menu for a serial non- 
graphics printer: 


CONFIG-PRINT-SERIAL 
~GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


. 1 - Port (1=COM1: 2=COM2?:) 
; 4-Baud Rate (0=110 1=150 2=300 3=600 4=1200 5=2400 6=4800 7=9600) 
: 2 - Parity (O=None 1=Odd 2=Even) 
1 - Stop Bits (1 or 2) 
7 - Data Bits (7 or 8) 
| O-Line Feed (0=Yes 1=No) 
7 ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 
_ Follow the "Printer Menu Guidelines" section of 
this chapter, and refer to your printer manual to 
= change any of these settings. 
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Parallel Non-Graphics Printers 


To configure a Parallel Non-Graphics Printer, type 
02 from the CONFIG-PRINT menu and press 
<Enter>. The following menu displays: 


CONFIG-PRINT-PARALLEL 
-GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


1 - Port (1=LPT1: 2=LPT2: 3=LPT3:) 
O - Line Feed (O=Yes 1=No) 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


Refer to your printer manual and the "Printer 
Menu Guidelines" section of this chapter to change 
any parameters. 
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Advanced Color Technology (ACT) Printer 


Type 03 on the CONFIG-PRINT menu and press 
<Enter> to display the menu for an ACT graphics 
printer: 


CONFIG-PRINT-ACT 


-GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


1 - Zoom (1 to 8) 

002 - Zoom Y (1 to 255) 
6 - Aspect Ratio (2=0.85 3=1.0 4=1.133 5=1.275 6=1.417 
1 - Black/White (1=Reverse 2=As Is) 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


Refer to your printer manual and the "Printer 
Menu Guidelines" section of this chapter to change 
any parameters. The changes you make override 
the DIP switch settings on your printer while 
IRMA 3279 Graphics is in use. When you stop 
using IRMA 3279 Graphics, the printer reverts to 
its usual hardware DIP switch settings. Parameters 
set with DOS utilities are not affected by 
selections made with this menu. 
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Quadjet Printer 


To configure a Quadjet Printer, type 04 from the 
CONFIG-PRINT menu and press <Enter>. The 
following menu displays: 


CONFIG-PRINT-QUADJET 


-GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


1 - Rotation (1=0° 2=90°) 

1 - Aspect Ratio (1=1:1 2=3:4) 

1 - Black/White (1=Reverse 2=As Is 3=Only) 
1 - Strike (1=Single 2=Double) 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


The first option on this menu, "Rotation," allows 
you to print full-width screen displays on the 
Quadjet printer. To use this option, type a "2" 
over the "1" in the space preceding "Rotation." 
This turns the image 90° so that data displayed 
left-to-right on the screen prints top-to-bottom on 
the page. To return to normal printing, type a "1" 
over the "2." 


For information about the other items on this 
menu, refer to your printer manual. Be sure to 
follow the "Printer Menu Guidelines" section of 
this chapter when changing parameters. 
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IBM 5182 Printer 


Type 05 on the CONFIG-PRINT menu and press 
<Enter> to display the configuration menu for an 
IBM 5182 printer: 


CONFIG-PRINT-IBM-5182 


-GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


3 - Aspect Ratio (1=1:1 2=6:5 3=3:4 4=6:5x3:4) 
1 - Black/White (1=Reverse 2=As Is) 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


Refer to your printer manual and the "Printer 
Menu Guidelines" section of this chapter to change 
any parameters. Note that the values you select 
override the DIP switch settings on your printer 
while IRMA 3279 Graphics is in use. When IRMA 
3279 Graphics is not in use, the printer uses its 
original hardware DIP switch settings. Parameters 
set with DOS utilities are not affected by 
selections made with this menu. 
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Tandy CGP-220 Printer 


To configure a Tandy CGP-220 graphics printer, 
type 06 from the CONFIG-PRINT menu and press 
<Enter>. The following menu displays: 


CONFIG-PRINT-TANDY 
-GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


1 - Rotation (1=0° 2=90°) 
1 - Aspect Ratio (1=1:1 2=3:4) 
1 - Black/White (1=Reverse 2=As Is 3=Only) 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


The first option on this menu, "Rotation," allows 
you to print full-width screen displays on the 
Tandy printer. To use this option, type a "2" over 
the "1" in the space preceding "Rotation." This 
turns the image 90° so that data displayed left-to- 
right on the screen prints top-to-bottom on the 
page. To return to normal printing, type a "1" over 
the "2." 


For information about the other items on this 
menu, refer to your printer manual. Be sure to 
follow the "Printer Menu Guidelines" section of 
this chapter when changing parameters. 
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IBM 3852 Printer 


Select 07 from the CONFIG-PRINT menu to 
display the IBM 3852 menu: 


CONFIG-PRINT-IBM-3852 


-GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


1 - Rotation (1=0° 2=90°) 

1 - Aspect Ratio (11:1 2=3:4) 

1 - Black/White (1=Reverse 2=As Is 3=Only) 
1 - Strike (1=Single 2=Double) 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


The first option on this menu, "Rotation," allows 
you to print full-width screen displays on the IBM 
3852 printer. To use this option, type a "2" over 
the "1" in the space preceding "Rotation." This 
turns the image 90° so that data displayed left-to- 
right on the screen prints top-to-bottom on the 
page. To return to normal printing, type a "1" over 
the "2." 


For information about the other items on this 
menu, refer to your printer manual. Be sure to 
follow the "Printer Menu Guidelines" section of 
this chapter when changing parameters. 
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NOTE: Full screen pictures can be printed on 
an IBM 3852 without rotation. 


Canon PJ1080A Printer 


To display the menu for the Canon PJ1080A 
graphics printer, type 08 on the CONFIG-PRINT 
menu and press <Enter>. The following menu 
displays: 


CONFIG-PRINT-CANON-PJ1080A 


-GraphPac- 
IRMA 3279 Graphics 
(c) 1987 Digital Communications Associates, Inc 


1 - Rotation (1=0° 2=90°) 

1 - Aspect Ratio (1=1:1 2=3:4) 

1 - Black/White (1=Reverse 2=AsIs 3=Only) 
1 - Strike (1=Single 2=Double) 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


The first option on this menu, "Rotation," allows 
you to print full-width screen displays on the 
Canon printer. To use this option, type a "2" over 
the "1" in the space preceding "Rotation." This 
turns the image 90° so that data displayed left-to- 
right on the screen prints top-to-bottom on the 


page. To return to normal printing, type a "1" over 
the "2." 
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For information about the other items on this 
menu, refer to your printer manual. Be sure to 
follow the "Printer Menu Guidelines" section of 
this chapter when changing parameters. 


Toshiba P351C Printer 


To display the configuration menu for a Toshiba 
P351C printer, type 09 on the CONFIG-PRINT 
menu and press <Enter>. The following menu 
displays: 


CONFIG-PRINT-TOSHIBA-P351C 


-GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


1 - Aspect Ratio (O=—5:6 1=1:1) 
1 - Black/White (1=Reverse 2=As Is) 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


Follow the "Printer Menu Guidelines" section of 
this chapter, as well as the instructions in your 
printer manual to change the values on this menu. 
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NOTE: In order to print graphs at the correct 
size, you must set the Vertical 
Movement Index (VMI) switch to 1/144" 
rather than !/256." Otherwise, your 
graphs will print at approximately 45% 
of their actual size. 


Toshiba P1351 Printer 


Type 10 on the CONFIG-PRINT menu and press 
<Enter> to display the configuration menu for a 
Toshiba P1351 black and white graphics printer. 
The following menu displays: 


CONFIG-PRINT-TOSHIBA-P1351 


-GraphPac- 
IRMA 3279 Graphics 
(c) 1987 Digital Communications Associates, Inc 


1 - Rotation (1=0° 2=90°) 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


The option on this menu, "Rotation," allows you to 
print full-width screen displays on the Toshiba 
printer. To use this option, type a "2" over the "1" 
in the space preceding "Rotation." This turns the 
image 90° so that Data displayed left-to-right on 
the screen prints top-to-bottom on the page. To 
return to normal printing, type a "1" over the "2." 
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For information about the other items on this 
menu, refer to your printer manual. Be sure to 
follow the "Printer Menu Guidelines" section of 
this chapter when changing parameters. 


Epson FX80 Printer 





To use an Epson FX80 black and white graphics 
printer with IRMA 3279 Graphics, select 11 from 
the CONFIG-PRINT menu. No additional menu 
displays. Continue with other configuration menus 
or press <Esc> several times to return to DOS and 
save your configuration to the GRAPH.DAT file. 


GTC Blaser Printer 


To use a GTC Blaser black and white graphics 


printer with IRMA 3279 Graphics, select 12 from 
the CONFIG-PRINT menu. No additional menu 
displays. Continue with other configuration menus 
or press <Esc> several times to return to DOS and 
save your configuration to the GRAPH.DAT file. 


Hewlett Packard LaserJet 


To set up an HP LaserJet printer to run with 


IRMA 3279 Graphics, select 13 from the CONFIG- 


PRINT menu. No additional menu displays. 


Continue with other configuration menus or press 


<Esc> several times to return to DOS and save 
your configuration to the GRAPH.DAT file. 
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Do I Need to Configure the Keyboard? 
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You do not have to use GraphPac’s keyboard 
configuration option if both of the following 
conditions exist: 


o you have a standard 83/84 key IBM PC, PC AT 
or PC XT keyboard 


o you want to use the default 3279 keyboard 
layout: the Attribute Select Typewriter/APL 
keyboard. (The default 3279 keyboard provides 
12 PF keys, color and highlighting attribute- 
select keys, and APL symbols.) 


If you have an IRMAkey or IBM Enhanced 
Keyboard or if you want to change the 3279 
keyboard assignment, you must use the keyboard 
configuration option. The following sections show 
how to change the default assignments. 
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Starting Keyboard Configuration 


To start keyboard configuration, go to GraphPac’s 
CONFIG menu and select item 2, "Configure 
Keyboard." The following menu displays: 


CONFIG-KEYBOARD 
-GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


1 - Configure 3279 Keyboard Type 
2 - Configure 3279 Keyboard Mapping 
3 - Configure PC Keyboard Type 


___ - Select One 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


This menu lists the available keyboard options. 
Remember, if you don’t select an option, the host 
assumes you want the 3279 Attribute Select 
Typewriter/APL keyboard assigned to a standard 
83/84 key PC keyboard. To choose an option, type 
the item number in the space to the left of "Select 
One" and press <Enter>. A new menu displays for 
the selected option. The three options are 
discussed in the following sections. 
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Changing the 3279 Keyboard Type 


If you do not select a 3279 keyboard, the default 
keyboard (Attribute Select Typewriter/APL 
keyboard) is used. The default keyboard is 00 on 
the following menu. To change the 3279 keyboard 
type, enter 1 on the CONFIG-KEYBOARD menu. 
The following menu displays listing the three 3279 
keyboard types you may use. (These keyboards are 
illustrated on your templates and in Appendix A.) 


CONFIG-KB-3279 
-GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


00 - Typewriter/APL/Attribute Select/U-S. (12 pf keys) 
01 - Typewriter/Attribute Select /U.S. (24 pf keys) 
02 - Typewriter/APL/U:S. (12 pf keys) 


00 - Select One 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


Select a 3279 keyboard by typing the item number 
in the "Select One" field and pressing <Enter>. 
With this change, the new 3279 keyboard will be 
assigned to the standard PC keyboard when you 
Start the GRAPH emulator. If you have a 
standard keyboard, you are finished with the 
configuration. Press <Esc> several times to exit 
GraphPac, or use other GraphPac configuration 
options. If you need to select a different PC 
keyboard, go to the section entitled, "Selecting an 
IRMAkey or IBM Enhanced Keyboard." 
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NOTE: You must select keyboard 0O1 in order to 
have all 24 PF keys. 


Changing the Keyboard Mapping 


The second option on the keyboard configuration 
menu is an advanced keyboard remapping option. 
Since this procedure can radically alter your 
keyboard, possibly making some functions 
unavailable, we recommend that you create macros 
with the <Alt><+> procedure provided by the 
KMACDRV.SYS driver. This procedure is 
described in Chapter 6. The keyboard remapping 
option on this menu is explained in Appendix F. 


Selecting an Alternate PC Keyboard 


To use an IRMAkey keyboard, an RPQ keyboard, 
or an IBM Enhanced keyboard with IRMA 3279 
Graphics, type 3 on the CONFIG-KEYBOARD 
menu and press <Enter>. The following menu 
displays: 


NOTE: You do not have to specify an option 


from this menu to use a standard 83/84 
key PC keyboard. 
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CONFIG-KB-PC 
-GraphPac- 
IRMA 3279 Graphics 
(c) 1987 Digital Communications Associates, Inc 


00 - PC/XT/AT (83/84 key) 
01 - XT/AT Enhanced (101/102 key) 
02 - IRMAkey/3270 


00 - Select One 
2 - slot 
ibmgraph __ - profile 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


Selecting an Enhanced Keyboard 


To select an IBM Enhanced Keyboard, type 01 in 
the "Select One" field and press <Enter>. The 
values for the "slot" and "profile" field are 
automatically assigned as follows: 


2 - slot 
ibmgraph _ - profile 


The "slot" field directs the emulator to load the 
keyboard profile into memory slot 2. Do not 
change this value. The "profile" field tells the 
emulator to load the keyboard profile, 
"ibmgraph.kyb." Make sure that this file resides in 
the same directory as the GRAPH.EXE emulator 
file. You can insert a custom keyboard profile in 
place of "ibmgraph." See the following section for 
details. 
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Selecting an IRMAkey Keyboard 


To select an IRMAkey keyboard, type 02 in the 





"Select One" field and press <Enter>. The values 
for the "slot" and "profile" field are automatically 


assigned as follows: 


2 - slot 
irmakey __ - profile 


The "slot" field directs the emulator to load the 
keyboard profile into memory slot 2. Do not 
change this value. The "profile" field tells the 
emulator to load the keyboard profile, 
"irmakey.kyb." Make sure that this file resides 


in 


the same directory as the GRAPH.EXE emulator 


file. You can insert a custom keyboard profile 
place of "irmakey." 
details. 


in 


See the following section for 


NOTE: If you want to use all 24 PF keys, be 
Sure you select the 3279 Attribute Select 
Typewriter keyboard, item 02 on the 
CONFIG-KB-3279 menu. See "Changing 


the 3279 Keyboard Type" for 
instructions if necessary. 


Selecting an RPQ Keyboard 


To use an RPQ keyboard, go to the CONFIG-K 


B- 


PC menu (shown on the previous page) and select 


the PC keyboard you are using: 00 - PC/XT/A 


T, 


01 - XT/AT Enhanced, or 02 - IRMAkey. Press 
<Tab> to move to the "profile" field and type in 
the name of the RPQ keyboard profile you want to 


use: 8K0808 or 8K1163. After typing one of 


these profiles press the <Esc> key to return to the 


previous menu. If you want to perform other 
functions continue with the GraphPac 
configuration. If you have completed 
configuration, press <Esc> as many times as 
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necessary to return to DOS and save your changes 
in the GRAPH.DAT file. 


Using a Custom Keyboard Profile 


When you start the GRAPH emulator, the 
keyboard profile specified on the CONFIG-KB-PC 
menu (ibmgraph or irmakey) is automatically 
loaded. If you have created an alternate keyboard 
profile with the KYBDEDIT program in Chapter 
7, you can load this profile in place of the 
standard profile. 


To automatically load an alternate profile, type 
the name of the alternate file in place of the 
standard filename on the CONFIG-KB-PC menu. 
For example, if IRMAkey keyboard is specified, 
the last entry on the CONFIG-KB-PC menu looks 
like this: 


irmakey _ -profile 
Type your alternate filename over "irmakey": 
altfile -profile 


The new profile will load automatically when you 
Start the GRAPH emulator. 


For instructions on loading multiple keyboard 
profiles, see Chapter 7. 


Customizing the Video Display 
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The video customization menu allows you to 
specify the type of monitor you are using and to 
change the blue color from dark blue to bright 
blue. To display the Video Customization Menu, 


Oy 


P ena azacae 5 | 


Chapter 2 - Software Configuration 





enter 3 from the GraphPac HOME menu. The 
following menu displays: 


CONFIG-VIDEO 
~GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


1 - Configure Monitor 
2 - Configure Alternate Color 


___ - Select One 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


Select an item from this menu to configure by 
typing the desired number (1 or 2) in the "Select 
One" field. Then press <Enter>. Each of these 
items is described on the following pages. 


Specifying Monitor Type 


To display the menu for monitor configuration, 
type 1 in the "Select One" field on the CONFIG- 
VIDEO menu and press <Enter>. The following 
menu displays listing the monitors that you can 
use with IRMA 3279 Graphics: 
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CONFIG-VIDEO-MONITOR 


-GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


O01 - Default 08 - Electrohome ECM-1301 

02 - Amdek Color 710 09 - Aydin Controls 8810LP 

03 - IBM 5153 10 - IBM 5154 Enhanced Color 

04 - JVC GD-H1014LP 11 - AT&T 6300/Olivetti M24 

05 - Microvitec 14L86 DD2U 12 - NEC MULTISYNC with CGA 
06 - PGS HX-12LP 13 - NEC MULTISYNC with EGA 


07 - Zenith ZVM-136 


O1 - Select One 


am ee eee mp ae Ss ee ee em ee ee ee ee ee ee eee ee we me Oe me ow oe om cee me we ee ee om 8 ee ie ee ee ee 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


Type the number that identifies the monitor you 
are using and press <Enter>. Your selection is 
automatically written in the GRAPH.DAT file 
upon exiting GraphPac and will be effective when 
you start the GRAPH emulator. If you will be 
using different monitors with IRMA 3279 
Graphics, you can create several GRAPH.DAT 
configuration files. See "Creating Alternate 
GRAPH.DAT Files" in this chapter. 


NOTE: Option 01, Default, provides general 
settings that can be used by a varicty 
of monitors. Because one setting cannot 
provide the best operating 
configuration for all monitors, you 
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menu above. If your monitor is not 
listed, select the default setting, then 
contact DCA Customer Support for 
guidance. 


Changing the Video Color 


(This option applies only to AT&T color monitors 
and IBM Enhanced Color Monitors.) 


The second option on the CONFIG-VIDEO menu 
lets you select to display characters on the screen 
in bright blue, which shows up better against the 
regular blue screen background. From the 
CONFIG-VIDEO menu, type 2 in the "Select One" 
field and press <Enter>. The following menu 
displays with the choices of the default blue (dark 
blue) or the alternate blue (bright blue): 


CONFIG-VIDEO-COLOR 
-GraphPac- 
IRMA 3279 Graphics 
(c) 1987 Digital Communications Associates, Inc 
1 - Default Blue 


2 - Alternate Blue 


__- Select One 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 
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Type the number of your choice in the "Select 
One" field and press <Enter>. 


Configuring the Base Address 
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(This section does not apply to the upgrade.) 


The base address specifies where the IRMA 3279 
Graphics hardware is located in the PC. The 
software is configured for "autosearch" by default, 
which means that it automatically searches the 
four possible addresses where the hardware might 
be located. These addresses are 280 (the default), 
2A0, 2C0, and 300. 


For many users, the autosearch feature is 
satisfactory. However, if another board in your 
PC uses one of the autosearch addresses, or if you 
changed the base address jumpers on the IRMA 
3279 Graphics board, you must specify a base 
address with this option. The base address yoy set 
with this option, must match the base address set with 
the jumpers on the board (see Chapter 1). 


To set the base address, follow these steps: 


STEP 1: From the CONFIG menu, select the 
base address option, by typing: 


<5><Enter> 


The following menu displays: 
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CONFIG-BASE-ADDRESS 
-GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


() indicates current board address(es) 


280 (1,2) 
2A0 (2) 
2CO (2) 


300 (2) 


000 - Select Address (000 for auto search) 


Notes: (1) Factory shipped configuration 


(2) Address searched for in emulator 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


This menu lists the four base addresses to which 
you can set the IRMA 3279 Graphics hardware. 


STEP 2: Type the desired address in the space 
preceding "Select Address," and press 
<Enter>. 


NOTE: If you previously have used IRMA 3279 
Graphics with a specific base address 
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and want to return to autosearch, type 
000 in the space preceding "Select 
Address." The emulator will 
automatically search for the board at 
all four given addresses. 


The new base address will be written in the 
GRAPH.DAT file when you exit the GraphPac 
program. 


NOTE: If you are using other boards in your 
PC, be sure that each board is set to a 
different base address. Then be sure 
that you set the same base address for 
the board and its program. 


Exiting GraphPac 
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After you have finished configuring the software, 
exit GraphPac by pressing <Esc> as many times as 
necessary to return to the HOME menu. Press 
<Esc> one additional time. The following message 
displays: 


graph.dat changed, writing to current directory 


The changes you have made are written in the 
GRAPH.DAT file on your diskette or in your 
\DCA directory. The GRAPH emulator will look 
for the GRAPH.DAT file when you start 
emulation. If the emulator doesn’t find 
GRAPH.DAT, it uses the default configuration 
values coded on the hardware. 
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Returning to the Default Configuration 





If you want to return to the default configuration 
(see page 2-1), you must remove the GRAPH.DAT 
file from the emulator’s search path. To do this, 
perform one of the following functions: 


o Rename GRAPH.DAT to a file name of your 
choice. 


0 Copy GRAPH.DAT to a directory that is 
different from the directory in which you start 
the GRAPH emulator (cannot be \DCA). 


o Erase GRAPH.DAT. 


Creating Alternate GRAPH.DAT Files 





If you plan to use different printers, monitors, or 
keyboard types with IRMA 3279 Graphics, you 
need to create more than one GRAPH.DAT file to 
hold the different configurations. Perform the 
following steps to create and use an alternate 
GRAPH.DAT file. 


STEP 1: Rename the current GRAPH.DAT file 
or put it in a directory different from 
the one where the program files are 
stored. 


STEP 2: Run GraphPac from your program 
diskette or the \DCA directory of your 
hard disk and select the options for the 
new GRAPH.DAT file. 


To use the new GRAPH.DAT file, simply start the 
emulator from your program diskette or the \DCA 
directory where the new GRAPH.DAT file is 
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located. To use the original GRAPH.DAT file, do 
one of the following, according to whether you 
have a hard disk or floppy disk system. 


For floppy disks: 


o Rename the current GRAPH.DAT file. Then, 
rename the original to GRAPH.DAT or move 
the original back into the directory where the 
emulator resides. 


For hard disks: 


o Start the emulator from the directory where 
you copied the original GRAPH.DAT file. The 
emulator will search the \DCA directory for all 
the needed files. 


Selecting Attributes and 
Program Symbol Sets 


In order to use program symbols and attribute- 
select features, the control unit communications 
port where your coaxial cable is attached must be 
configured to operate with an IBM 3279 Model 
S3G terminal. To check the controller 
configuration, run the following test after 
installing the IRMA 3279 Graphics hardware and 
software. This test is equivalent to the "Extended 
Function and Programmed Symbols Test 
Procedure" for an IBM 3279 terminal. 


STEP 1: With the hardware and software 
installed, start the emulator by typing 
the following command at the DOS 
prompt. 


GRAPH <Enter> 
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STEP 2: 


STEP 3: 


STEP 4: 


STEP 5: 
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The IRMA 3279 Graphics copyright 
notice displays, followed by the 
emulation screen. 


Press the test function key: 
<Alt><F8> 


The word TEST appears on the status 
line. 


Type: 
/8 <Enter> 
Test patterns appear on the screen. 


If the controller is properly configured 
for a 3279 S3G terminal, the triangular 
symbols in the test pattern appear in 
red and white, and the numbers 1 
through 7 each appear in a different 
color. If you do not get similar test 
results, your controller is not 
configured to support the full range of 
IRMA 3279 Graphics features. 


To reset any attribute display to the 
application program’s original value, 
use the field inherit function. The 
field inherit function is assigned to the 
following key sequences: 


<Alt><Ins> resets highlighting 
<Alt><Del> resets program symbol sets 


<Alt><+> resets colors (the + is on 
the numeric keypad) 


To end the test session and return to 
emulation mode, press: 
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NOTE: 


<Alt><F8> 


If you have a problem using 
programmed symbols but normal text 
operations are working properly, see 
your system administrator and verify 
that the controller is configured to 
support an IBM 3279 Model S3G 
Display Station. Appendix G provides 
information the system administrator 
can use to configure the control unit 
and mainframe computer. 


Now, your PC and IRMA 3279 Graphics are ready 
for terminal emulation. Proceed to Chapter 3 for 
Operating instructions. 


Chapter 3 


S3G Terminal Emulation and Operation 


Introduction 


With the IRMA 3279 Graphics hardware installed, 
you can run the GRAPH.EXE emulation program 
to use your PC as a 3279 S3G graphics terminal. 
This chapter shows how to start 3279 graphics 
emulation, provides special command options, and 
shows how to make the emulator resident, as well 
as how to switch between DOS and emulation 
mode. You should read all of this chapter before 
Starting emulation. 


NOTE: 


Refer to the following appendices for 
detailed information about specific 
topics: 


Appendix A: descriptions of the 
keyboards and keys you can uSe in 
emulation 


Appendix B: status line symbols and 
messages with corrective action, where 
necessary 


Appendix C: corrective action for error 


messages that occur during all phases of 
program operation 
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Starting Emulation 





Follow these steps to start 3279 S3G emulation. 
Note that GRAPH.8X3 and GRAPH.FNT must 
reside in either the current directory or the DCA 
directory in order for the emulator to start. 


STEP 1: If you have a hard disk, boot the PC 
from the hard disk. If you have a 
floppy-disk system, boot from the 
Keyboard Utilities diskette. Notice 
that two banners display one after the 
other, giving the keyboard driver title 
and revision number. If these banners 
do not display, review the installation 
steps in Chapter 2. 


STEP 2: If you have a hard disk, go to the 
\DCA directory. If you have a floppy- 
drive system, put the program diskette 
in drive A. 


STEP 3: At the DOS prompt, type: 
GRAPH |[-f] [-v] [-e] [-r]’. <Enter> 


The GRAPH command loads the 
GRAPH.DAT file and starts the 
emulator. The four command options 
are -f (force download), -v (verbose 
mode, -e (initialize and exit), and -r 
(resident mode). For a complete 
description of the options, see the 
following sections. 


* 
Place -e last in a command line. 


Do not use -r with -e. 
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; After you enter the GRAPH command, a screen 

| displays giving the DCA copyright notice and the 
GRAPH emulator version number. If the emulator 
doesn’t find the GRAPH.DAT file in the current 
directory or in the \DCA directory, a message 
displays. If you created the file with GraphPac, 
check the current directory and the \DCA 
directory. If the file does not exist, run GraphPac 
to specify your system options. The GRAPH.DAT 
file will ensure proper operation of the emulator 
with your PC and attached devices. GRAPH will 
use the default configuration values if 
GRAPH.DAT is not found (see the GraphPac 
Configuration Chart in Chapter 2 for default 
values). 


STEP 4: Now the screen display changes. At the 
bottom of your screen the status line 
displays the number 4, indicating that 
the PC 1s attached to an IBM 3174 or 
3274 controller: 


: a] A 


If the number 4 is not shown on your screen, 
check the coaxial cable that connects the 
controller to your PC. This cable should be 
securely attached. If you do not see the 
number 4 after securing the cable, contact 
your host system administrator or DCA 
Customer Support. 


3 STEP 5: When the question mark (?) is replaced by a 
stick figure, 


4] A [i] 


you can enter your logon sequence. 


cet 
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If the question mark is not replaced by the 
stick figure, press the SYS REQ function 
key, <Alt><Fl>. When the question mark is 
replaced by the stick figure, you can enter 
your logon sequence. (These symbols and all 
the status line symbols are described in 
Appendix B.) 


NOTE: (If the status line scrolls off the bottom of 
your screen, adjust the vertical control knob 
on the back of the monitor to bring the line 
up to the bottom of the screen.) 


Once you have gained access to the mainframe, you can 
work with graphics application programs like GDDM, 
SAS/GRAPH, and TELLAGRAF. Your host system 
administrator and the program documentation can assist 
you in accessing and using these programs. 


Emulator Startup Command Options 


The four GRAPH command options are described in the 
following sections. To use an option, type a space after 
the GRAPH command, then type a dash and the option 

letter. For example: 


GRAPH -e 


To use more than one option, type the desired options on 
one line, putting a space between each: 


GRAPH -r -f -v 


The four options are described below. 
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Verbose Reporting (-v) 


Using the -v option with GRAPH causes IRMA 3279 
Graphics to display the current status of each of the 
emulator startup steps. The verbose report appears when 
the emulator is started and disappears when the 
emulator becomes active and the host session begins. On 
the following screen, the verbose report follows the 
version number: 


IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc. 
1000 Alderman Dr., Alpharetta, GA 30201 
All Rights Reserved 


Version 1.17 


Verbose Option On... 
graph.dat found in current directory, Version 1.17 
Board found by auto search at address 280 


The first line of the report lists the option(s) 
included with the GRAPH command. The second 
line displays the status of the GRAPH.DAT file. 
(if GRAPH.DAT is not found, the emulator uses 
the default values; see Chapter 2.) The third line 
reports the address where the IRMA 3279 Graphics 
hardware was found and the method that was used 
to find it. The fourth and fifth lines may or may 
not appear, depending on whether the startup 
procedure required GRAPH to search for the 
GRAPH.8X3 and GRAPH.FNT files. When these 
lines appear, they display similar to those shown 
for GRAPH.DAT. 


When you exit the emulator, the verbose report 
remains on the PC screen until you clear the 
screen or enter a DOS command (such as DIR) that 
will scroll the report off the screen. 
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Resident Mode (-r) 


Typing a -r in the GRAPH command line makes 
the GRAPH emulator resident in the PC’s memory. 
The resident emulator occupies 58 kilobytes of 
Random Access Memory (RAM). After you enter 
GRAPH -r you return to the DOS prompt. Now 
you can press both shift keys together (the "hot 
key") to quickly switch between DOS and 
emulation. 


When using the resident emulator, screen append 
and screen capture (see Chapter 4), as well as file 
transfer are not available. If you want to use one 
of these functions and you have made the 
emulator resident, you can load a non-resident 
copy of the emulator then use the desired function. 
See the section in Chapter 4 entitled, "Making the 
Emulator Resident" for specific instructions. 


NOTE: During a session you can make the 
emulator resident by pressing 
<Ctrl><Home> then <Esc>. You can 
also make the emulator resident by 
pressing <Esc> to display the extended 
functions prompt, then selecting "r." 
See Chapter 4 for more information. 


Force Download (-f) 


The forced download option causes GRAPH to 
reload the IRMA 3279 Graphics hardware with the 
GRAPH.8X3 and GRAPH.FNT files when GRAPH 
is restarted. This option is useful when the 
emulator gets "hung up." 


Note that the -f option terminates any active host 
session, so if possible, you should log off all active 
sessions before using this option. 
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Initialize and Exit (-e) 


Putting a -e after the GRAPH command causes 
GRAPH to initialize the emulator hardware and 
then exit without remaining resident. This 
establishes a connection from the PC to the 
mainframe computer without establishing an 
actual session. You can use this option with the -f 
and -y options, being sure to place -e last in the 
command line, e.g. GRAPH -f -v -e. Do not use the 
-e option with -r. 


Session Operation 


After you establish a connection with the host 
computer, a status line at the bottom of your 
screen displays symbols that report the status of 
various aspects of the current session. While most 
of the symbols report user-selected information, 
such as the highlighting mode and program symbol 
Set in use, the first two areas of the status line 
relay information that directly concerns program 
Operation. These areas are described in the 
following sections. 


Checking the Network Connection 


The area farthest to the left on the status line 
provides information about your connection to the 
network. A number 4 displaying in this area 
Shows that you are connected to a 3174 or 3274 
controller. When a question mark displays in this 
area, the emulator is running, but your computer is 
not communicating with either the host application 
program or the network control program. To 
resume operation, make sure that you are logged 
on to the host and have executed the application 
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program startup command. If the question mark 
occurs during a session, press the reset key, <F10>, 
to resume operation. For a description of other 
symbols that display in this category, see Appendix 
B. 


Unlocking the Keyboard 


The area of the status line adjacent to the system 
connection area gives the status of the data 
entered at the keyboard. When symbols display in 
this area, your keyboard usually is locked, waiting 
for the host to finish processing your last request 
or for you to correct a data entry error. If the X 
clock symbol appears, the host needs more time to 
process your entry. The keyboard will unlock 
when the X clock symbol disappears. Most of the 
other symbols can be cleared by pressing the reset 
key, <F10>. See Appendix B for a complete listing 
of symbols and their messages. 


Reading the Status Line 


The remaining areas of the status line remind you 
of the operating mode selections you have made. 
One area also indicates the status of the printer. 
The following diagram shows the categories of 
symbols that display on the status line. Specific 


symbols and their meanings are listed in Appendix 
B. 
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[4] ALG xx 4Z__onnn 
21-27 
Reminder 
Messages 
9-17 
Do Not Enter 
Messages 
1-6 
Readiness & System 
Connection Messages 31-34 
Program 
Symbol Set 


NOTE: Not all symbols will display on the status line at one time. 


Figure 3-1: The Status Line 


APL 


36-44 
Shift 

& Mode 
Messages 


46-47 
Highlighting 
Messages 


52 
Insert 
Mode 


49-50 
Color 


Indicator 


60-64 
Printer 
Status 
Messages 





75 
Resident 


Mode 


Indicator 
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Saving and Printing Host Data 


To save and print text and graphics generated with 
your mainframe programs, you can use a special 
feature of IRMA 3279 Graphics: the extended 
functions prompt. Press <Esc> anytime during the 
session to display the extended functions prompt 
on your screen. From this prompt you can append 
text to a PC disk file, capture text and graphics in 
a PC disk file, print your data at the PC printer, 
and perform a variety of other functions. Chapter 
4 describes each of the extended functions. You 
Should review Chapter 4 before using the extended 
functions prompt. 


Exiting and Restarting 
the GRAPH Emulator 








There are two ways to exit a host session and 
return to DOS: 


o press <Esc> to display the extended functions 
prompt, then press e 


o press both shift keys together at the same time 
(hot key) 


To return to the host session, re-enter the GRAPH 
command at the DOS prompt. If the emulator is 
resident, you can simply press both shift keys (the 
"hot key") to restart emulation. 


NOTE: There are three ways to make the 
emulator resident: 


1) Use the -r option with the GRAPH 
command when starting the 
emulator (see "Emulator Startup 
Command Options" in this chapter) 


| as | 
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2) Press <Ctrl><Home> anytime during 
a session, then press <Esc> 


3) Select resident mode from the 


extended functions prompt (see 
Chapter 4). 
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Chapter 4 
Extended Functions 


Introduction 


IRMA 3279 Graphics enables the PC to perform 
online and offline functions that are not available 
with a 3279 S3G terminal. Online with the host, 
the extended functions prompt gives you the 

zi ability to save and print host graphics screens at 
the PC and recall saved graphics files without 
exiting the session. Offline in PC mode, the 
GraphPac utilities let you redisplay and print 
graphics files locally, without having to connect to 
the network. This chapter explains how to use 
these special functions. 


Accessing the Extended Functions Prompt 





To display the extended function prompt on your 
screen, press <Esc>. The following prompt 

displays: 

a)ppend c)apture e)xit p)rint r)esident t)est x)recall ESC to cancel 


These functions are described in the following 
! chart: 
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GraphPac Extended Functions 


Extended 

Function Action 

append appends a screen of host text to a PC 
disk file 

capture Saves a screen of text and/or graphics 
in a PC disk file 

print prints a screen of host text” 

resident makes emulator resident 

recall redisplays a graphics file during a 
session 

test resets error conditions (similar to a 
"power on reset") 

* 


To print graphics and to redtsplay text, use the 
GraphPac utility described at the end of this 
chapter. 


To select a function from the prompt, type the 
first letter of the function, then press <Enter>. 

For example, to "append" a file, type "a" and press 
<Enter>. (Exception: if you want to use the 
"recall" function, enter "x.") The following sections 
Show how to use each function. 
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Appending Text to a PC Disk File (Append) 


NOTE: This function is not available with the 
resident emulator. Re-enter the Graph 
command to use this function. See 
"Resident Mode" in this chapter for 
complete instructions. 


The append function adds the current display of 
host text to any specified DOS file on your disk. 
The primary purpose of append is to convert host 
EBCDIC text into ASCII for use with a PC 
application program. In the conversion process, 
highlighting, color, and redisplay features are lost. 
If you want to store a text screen in color and be 
able to recall the screen, use the "capture" function 
described in the following section. 


To append a screen of text to a disk file, follow 
these steps. You can stop an append at any time 
by pressing the <Esc> key. 


STEP 1: When the screen displays the text that you 
want to append to a file, press the <Esc> key. 
The extended functions prompt displays at 
the bottom of your screen. 


a)ppend c)apture e)xit p)rint r)esident t)est x)recall ESC to cancel 
STEP 2: Type: 

a <Enter> 

The following prompt displays: 

Enter Filename: 


STEP 3: Enter the name of the PC disk file to 
which you want to save the screen. If 
you want to save the screen in a new 
file (one that you have not yet created) 
enter any legal DOS filename, including 
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STEP 4: 


a drive designation, directory path, and 
extension. The following message 
displays: 


File Append in Progress 


The text screen is appended to the 
specified file, then you are returned to 
emulation mode. 


To append another file, display the 
next screen you want to save and press 
the <Esc> key. Then enter a for 
append. The following prompt displays: 


Enter new filename or <CR> for XXX: 


"XXX" is the name of the file specified 
in the previous append. If you want to 
Save this screen in the same PC file as 
the previous append, press the <Enter> 
key. If you want to add the screen toa 
different PC file, enter the new 
filename. 


Capturing Text and Graphics 
in a PC Disk File (Capture) 


NOTE: 


This function is not available with the 
resident emulator. Re-enter GRAPH to 
use this function. See "Resident Mode" 
in this chapter for specific instructions. 


The screen "capture" function saves the current 
display of host text and/or graphics in a PC disk 
file. Highlighting and color are maintained, and 
the file can be redisplayed online or offline, 
exactly as it was captured. 


Chapter 4 - Extended Functions 





Follow these steps to capture a screen of graphics 
or text in a PC disk file. Press <Esc> at any time 
to cancel the capture. 


STEP 1: When the screen displays the data you 
want to save, press <Esc>. The 
extended functions prompt displays: 


a)ppend c)apture e)xit p)rint r)esident t)est x)recall ESC to cancel 
STEP 2: Press: 

c <Enter> 

The following prompt displays: 

G)raphics or T)ext 


STEP 3: If you want to save, recall, and print 
the captured screen of graphics or text 
as it appears on your display, select g. 
If the display contains only text and 
you do not want to save its color 
features or use the Recall option with 
it, select t, which is similar to an 
append. 


STEP 4: After you enter g or t, the program asks 
you to enter the name of the file to 
which you are saving the screen. Type 
a valid DOS file name, including a 
drive designation and path, if you want 
to capture the screen on a different 
drive or in a different directory from 
the current. The screen is saved in the 
specified PC disk file, and you return 
to emulation. 


CAUTION: You should specify a different 
filename for each file saved with the 
capture option. If you try to capture 
a screen to an existing file, the new 


ery 
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data writes over the existing data. 
Note that you can append text files 
to any captured file. 


NOTE: We recommend that you do not add an 
extension to files saved as graphics files 
(see STEP 3). If you do not specify an 
extension, the Capture function adds 
the extension .GRF to your file. This 
.GRF extension will differentiate files 
that can be recalled from ones that 
cannot. (Files saved with the Append 
function or saved as text files with the 
Capture function cannot be recalled). 


Printing Text on a PC Printer (Print) 


The print function allows you to print a screen of 
host text on a printer attached to your PC. To 
print graphics, use the GraphPac "Print Menu" 
described later in this chapter. IRMA 3279 
Graphics must be configured for your printer 
before you can use this function (see Chapter 2). 


NOTE: Do not use the <PrtSc> key to send 
graphics (non-alphanumeric symbols) to 
a printer, as results are unpredictable. 
Use the GraphPac "Print Menu" to print 
a screen that contains graphics. You 
can use the <PrtSc> key to print the 
current text Screen. 


Follow the steps below to print a screen of text. 
You can cancel the printer action at any time by 
pressing the <Esc> key. 


STEP 1: When the screen displays the text that 
you want to print, press the <Esc> key. 
The extended functions prompt appears 
at the bottom of the screen: 
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a)ppend c)apture e)xit p)rint r)esident t)est x)recall ESC to cancel 
STEP 2: Press: 
p <Enter> 


The current screen is sent to the printer 
attached to your PC. The following 
message displays: 


Printing ... (Esc to cancel) 


Recalling a Screen of Graphics (Recall) 


The recall function lets you redisplay during a 
session, any graphics or text file that you’ve saved 
on diskette with the Capture option. To recall a 
screen to your display, follow the steps below. 


STEP 1: During the session, press the <Esc> key 
to display the extended functions 
prompt: 


a)ppend c)apture e)xit p)rint r)esident t)est x)recall ESC to cancel 


STEP :2: Press x <Enter> to select recall. All 
files saved with the capture option 
display on your screen, and you are 
prompted for a filename. If the list of 
files is too long to display on the screen 
at once, use the cursor up and cursor 
down keys to scroll the file listing if 
necessary. 


NOTE: If you did not specify an extension 
when you captured files with the G 
specification (see the Capture option), 
IRMA 3279 Graphics assigned the 
extension, .GRF, to the captured files. 
Files with the .GRF extension can be 
recalled. 
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STEP 3: Enter the name of the file you want to 
recall. Note that you can display only 
files saved with the Capture’s G 
specification (see the Capture option). 
These files will have a .GRF extension, 
if you did not assign another extension. 


Once the contents of the file display, you can 
proceed with any operation. To restore the 
previous host screen, press the Clear function key. 
This key might be <Clear>, <PAI>, or <PA2>, 
depending upon your application program’s 
assignment. 


Making the Emulator Resident 


If you did not start the emulator with the resident 
option, -r, you can do so during a session in two 
ways. You can press <Ctrl><Home> during the 
session, then press the <Esc> key, or you can use 
the extended functions prompt by following these 
steps: 


STEP 1: During emulation, press the <Esc> key 
to display the extended functions 
prompt at the bottom of your screen. 


a)ppend c)apture e)xit p)rint r)esident t)est x)recall ESC to cancel 
STEP 2: Press, 

r <Enter> 

to activate resident mode. 


The emulator program becomes resident 
in the PC’s memory and returns you to 
the DOS prompt. You can return to 
emulation by pressing <Shift><Shift>. 
The PC screen will display the most 
recent screen sent from the controller. 
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Note that an R displays in column 75 
of the status line to indicate that IRMA 
3279 Graphics is running in resident 
mode. 


NOTE: The resident emulator uses 58 kilobytes 
of memory. 


Functions Unavailable 
with the Resident Emulator 


Due to DOS limitations, screen append, screen 
capture, and file transfer are not available from 
the resident emulator. In order to use these 
functions when the emulator is in resident mode, 
you can load and use a nonresident copy of the 
emulator. Follow these steps: 


STEP 1: During an emulation session, press the 
hot key to return to DOS. 


STEP 2: At the DOS prompt, type, 
GRAPH <Enter> 


to start the emulator with a nonresident 
copy of GRAPH. 


STEP 3: Use the extended function you desire, 
or perform a file transfer. 


STEP 4: When you complete your operation, 
press the hot key to exit the emulator 
and clear the nonresident copy of 
GRAPH. 


STEP 5: At the DOS prompt, press the hot key 
again to return to emulation using the 
resident emulator. 
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Power On Reset (Test) 





The local test function is similar to the 
Test/Normal switch on the 3279 terminal and is 
used to reset error conditions that result after the 
coaxial cable has been moved between personal 
computers or after the keyboard type has been 
changed. This function fills the screen with all 
displayable characters, initializes the controller 
connection, and 

sends a message to the controller about the type of 
keyboard in use. The local test function causes a 
power-on-reset condition and ends the session. If 
possible, log off the host session before entering 
test mode. To use this function, follow these steps: 


STEP 1: Press <Esc> to display the extended 
functions prompt. 
a)ppend c)apture e)xit p)rint r)esident t)est x)recall ESC to cancel 
STEP 2: Select the test function by pressing: 
t <Enter> 


STEP 3: To exit the local test function, press 
<Esc>. 
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Printing and Recalling Screens 
Offline from the Host 





Two convenient functions of the GraphPac utility 
program let you print and redisplay host screens 
offline from the host. Thus you can work with 
host graphics or text without having to be 
connected to the network. To use these functions, 
start GraphPac from the default drive and 
directory by typing the following command at the 
DOS prompt. (Note that the GRAPH emulator 
does not have to be active to use GraphPac.) 


Type: 
GP <Enter> 


The following menu displays: 


HOME -GraphPac- 
IRMA 3279 Graphics 
(c) 1987 Digital Communications Associates, Inc 
1 - Print Saved Graph 
2 - Recall Saved Graph 
3 - Configuration 
O - Exit 
___ Select One 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 
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The first option on this menu lets you print 
graphics screens saved in PC disk files. The 
second option lets you recall files containing text 
and graphics screens. (The third option, 
"Configuration" is explained in Chapter 2.) To 
select an option, type the option number in the 
field preceding "Select One" and press <Enter>. 
Pressing 0 or <Esc> returns you to DOS. The 
following sections discuss how to use options 1 and 
2. 


NOTE: To move the cursor on this menu and 
all submenus, use these keys: 
backspace, backtab, cursor down, cursor 
left, cursor right, cursor up, Enter, 
escape, Home, and Tab. Fora 
description of each key’s function, 
refer to Appendix A. 


Printing Graphics on the PC Printer 





Press 1 <Enter> from the HOME menu to select the 
print option. This option lets you print a graphics 
file saved with the capture option on the printer 
attached to your PC. After you select 1, the 
following print menu displays: 
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PRINT -GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


Enter Name of Graph File To Print 


(A listing of the first 80 directory files with the extension, .GRF, 
displays here in alphabetical order.) 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


| Enter the filename and extension of the file you 

| want to print, including a path name if the file is 
in a directory other than the current one. Your 
entry will look similar to the following: 


filename Enter Name of Graph File to Print 

If you do not specify an extension, the emulator 
assumes that the extension is .GRF. To print a file 
that does not have an extension, type a period 


after the filename, i.e. filename. Press <Enter> to 
print the file. 
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Recalling Text and Graphics 


This option recalls files saved with the capture 
option when "g" was specified (see the section on 
capturing files). Select 2 from the HOME menu, 


and press <Enter> to display the recall menu: 


RECALL -GraphPac- 
IRMA 3279 Graphics 


(c) 1987 Digital Communications Associates, Inc 


Name of File To recall 


DCA STYLES IRMAPIE 


ESC -- Previous Menu ENTER -- Process Selection TAB -- Next Field 


The area following "Name of File To recall," 
displays the first 80 directory files with the .GRF 
extension. The distribution diskette contains three 
sample .GRF files, which are listed on this menu. 
To recall one of the sample files (or any .GRF 
file), type the filename in the space provided on 
the screen. For example, to recall the DCA.GRF 
file, type "DCA" in the provided space: 


DCA Name of File to Recall 


If you do not type an extension, the .GRF 
extension is assumed. To recall a file that has no 
extension, type a period after the filename, i.e. 
filename. You may also include a drive 
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designation and a pathname if the file is on a 
drive or in a directory other than the current one. 


Press <Enter> to display the file contents on your 
screen. Press any key to return to the recall menu. 


Video Reset (VR) 





The video reset program resets the IRMA 3279 
Graphics video controller after the emulator has 
been abnormally exited. The VR command resets 
the GRAPH board so that the DOS screen can be 
displayed. 


To reset the emulation screen to the DOS screen, 
type the following at the DOS prompt: 


VR [xxx] <Enter> 


The [xxx] option allows you to specify the base 
address of the IRMA 3279 Graphics hardware. If 
you do not specify the base address, the default 
address of 280 is assumed. 


If you want to automatically reset the video 
controller to DOS each time the PC is booted, 
include the VR command in your 
AUTOEXEC.BAT file. Refer to your DOS manual 
for instructions on creating or editing an 
AUTOEXEC.BAT file 
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Chapter 5 
E78 Emulation 


Introduction 


This chapter is provided for users who want to run 
E78 on the IRMA 3279 Graphics hardware. E78 1s 
a program contained on the IRMA diskette that 
provides 3278/3279 Model 2 terminal emulation. 
The E78 program provides text emulation only. 
E78 does not provide graphics terminal emulation. 


You do not have to use E78, as the GRAPH 
program provides text as well as graphics 
emulation. However, if you want to use a light 
pen or write your own programs using DCA 
BASICA and C subroutines, you must use E78. 
You might also want to take advantage of E78’s 
compatibility with the following software. 


Micro-to-Mainframe Link Software: 


o Interactive PC Link!M o Golden GateIM 
o Linkit!M o PanLinkiM 

o PC Focus Link!M o Expert Link !M 
o TempusLink 


PC Application Software: 


Symphony !M 
Lotus 1-2-3 1M 
Microsoft Word /M 
Displaywrite !M 2 and 3, 
WordStar!M 


oo oo 6 


Only E78 versions 1.42 and above are compatible 
with the IRMA 3279 Graphics hardware. If you 
need the version 1.42 software or documentation, 
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you can order them by checking the last box on 
the product registration card located inside the 
back cover of this guide. 


Only E78 versions 1.42 and above run on the IRMA 
3279 Graphics hardware. 


Configuring the E78 Emulation Program 


The E78 emulator must be customized for certain 
options in order to run properly on the IRMA 3279 
Graphics hardware. To customize E78, use the 
GENX program located on the E78 diskette. The 
following steps show how to start GENX and give 
the options you must specify. 


STEP 1: If your PC is OFF, Booth with DOS as 
you normally do. 


If your PC is ON, exit all application 
programs, log off all sessions, and 
return to DOS. 


STEP 2: Put the E78 diskette in the default 
drive. 


STEP 3: At the DOS prompt, start GENX by 
typing: 


E78GEN <Enter> 


The following menu displays, listing the 
items you can specify with GENX: 
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E78 Terminal Emulator Customization Menu Rev 1.47. 12 March 1987 


1 - Disable 26th line status display 20 - Select IRMAlette Operation 
3 - Make emulator auto-resident 22 = Non-Standard Display Adapters 
5 - make 2 color mode default 
6 - Make 7 color mode default 24 - Force E78 to NOT allow APL 
25 - Disable EAB 
8 - Make SHOW COLUMNS default 


10 - Convert to pre-1.20 keyboard 


12 = Select KEYBOARD & SCREEN type 
13 = Set LIGHT PEN correction 

14 = PC look-alike setups 

15 = Setup COMI1: input parameters 


17 - Disable NON-DISPLAY display 
18 - Force dark blue to cyan 


99 = Exit GENX program 


Your selection: 


Your cursor will be in the space following "Your 
Selection." 


STEP 4: The first items you need to configure 
are the keyboard and screen types, 
option 12. Type 12 in the "Your 
Selection" field, and press <Enter>. The 
following menu displays: 
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Select KEYBOARD & SCREEN type 


1 - Typewriter (default) 17 - No attached keyboard 
2 - Typewriter 2/ numeric lock 18 - Reserved 0000 
3 - Typewriter, PSHIC 19 - Reserved 0011 
20 - Reserved 1011 
5 - APL 
6 - APL w/ numeric lock 22 - Mod 2 Screen (24x80) 
7 - APL, PSHICO 23 - Mod 8 Screen (32x80) 
24 - Mod 4 Screen (43x80) 
9 - Text 
10 - Text w/ numeric lock 26 - Mod 2 Full Screen IRMAvision 
27 - Mod 3 Full Screen IRMAvision 
12 - Data Entry 28 - Mod 4 Full Screen IRMAvision 


13 - Data Entry I w/ numeric lock 29 - Mod 5 Full Screen IRMAvision 
14 - Data Entry II 


15 - Data Entry II w/ numeric lock 31 - Enable IRMAvision Cursor Blink 


98 = Return to previous menu 99 = Exit GENX program 


Your selection: 


STEP 5: From this menu select option 7 - APL, 
PSHICO - by typing 7 in the "Your 
Selection" field and pressing <Enter>. 
This option installs a patch that lets 
you use an APL keyboard and 
Programmed Symbols set, extended 
HIghlighting, and extended Color 
Overlay. Note that a "+" displays after 
option 7 to show that this option has 
been specified. 
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STEP 6: Next select a Model 3 screen by typing 
23 in the "Your Selection" field and 
pressing <Enter>. This option installs a 
patch for a Mod 3 screen, which is 
required to use both emulators from the 
same hardware without experiencing 
screen malfunctions. Note that a "+" 
displays after option 23 to show that it 
has been selected. 


NOTE: To display the Full Mod 3 screen 
during E78 emulation, you must scroll. 


STEP 7: Type 98 in the "Your Selection" field 
and press <Enter> to return to the 
GENX Main Menu. 


STEP 8: At the main menu, type 22 and press 
<Enter> to specify the type of display 
monitor you are using. The following 
menu appears: 


E78 Terminal Emulator Customization Menu Rev 1.47 12 March 1987 


Non-Standard Display Adapters 


1 - IBM EGA Monochrome Display 

2 - IBM EGA Normal Color Display 

3 - IBM EGA Enhanced Color Display 
5 - Hercules Monochrome Board 

6 - Paradise with Monochrome Display 
7 - STB Chauffer display adapter 


98 = Return to previous menu 99 = Exit GENX program 


Your selection: 
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If you are not using any of the monitors listed on 
the menu, you do not have to make a selection. In 
this case, go to STEP 10. 


STEP 9: Find the number that identifies your 
display adapter and type it in the 
"Your Selection" field. Press <Enter> to 
install the patch. 


STEP 10: If there are other options you need to 
specify, type 98 in the "Your Selection" 
field to return to the main menu. 
Select the other options you need. 


(Refer to the IRMA User’s Guide for 
information about the other GENX 
options.) 


STEP 11: When you have specified all needed 
options, type 99 in the "Your Selection" 
field on the main menu (or submenu) 
and press <Enter> to exit the GENX 
program. 


A prompt tells you that the GENX 


Operation is complete, and you return to 
DOS. 


The GENX program creates two files on your 
diskette, CE78.EXE and CE78.LOG. CE78.EXE is 
the customized version of the E78 emulator, which 
you should use to start E78 emulation. CE78.LOG 
keeps a record of all the GENX options contained 
in the CE78 file. To review the contents of your 
customized emulator program, type the following 
command at the DOS prompt: 


TYPE CE78.LOG <Enter> 
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This command lists on your screen all the patches 
installed with GENX. 


Starting the E78 Emulator 


After completing the GENX configuration, follow 
these steps to start E78 emulation: 


STEP 1: 


STEP 2: 


NOTE: 





If you have a hard disk, boot the PC 
from your hard disk and go to the 
\DCA directory. 


If you have floppy disks, put the 
Keyboard Utilities diskette in drive A 
and the Program diskette in drive B. 
Boot from drive A. Go to drive B. 


At the DOS prompt, type the command, 
GRAPH -e 
and press <Enter>. 


This command initializes the IRMA 
3279 Graphics hardware and downloads 
the microcode into the Random Access 
Memory of the board. A copyright 
notice flashes on the screen, then you 
return to the DOS prompt. 


You can put the GRAPH -e command 
in an AUTOEXEC.BAT file. Then 
when you boot the PC with the IRMA 
3279 Graphics program, the microcode 
is automatically downloaded to the 
hardware, and you can use the 
emulation program you desire. See 
your DOS manual for instructions on 
creating an AUTOEXEC.BAT file. 
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STEP 3: 


STEP 4: 


CAUTION: 


STEP 5: 


STEP 6: 


STEP 7: 


Put the E78 diskette in the disk drive. 
At the DOS prompt where the E78 
diskette is located, type the command, 


CE78 <Enter> 
to start the E78 emulation program. 


When you have a connection to the 
host, you can log on to the desired 
application. 


Do not make both the E78 emulator 
and the GRAPH emulator resident at 
the same time as results are 
unpredictable. 


If you did not choose to make the 
emulator resident with GENX, you can 
do so now by pressing, <Ctrl><Home>. 
A prompt reads that E78 is becoming 
resident. Press <Esc> to continue. You 
return to the DOS prompt. Press the 
hot key to return to the emulation 
session. 


If you want to start a session with the 
GRAPH emulator, press the hot key to 
exit the E78 session and return to DOS. 
The E78 session continues, although it 
doesn’t currently display on your 
screen. At the DOS prompt, type the 
GRAPH command to start a 3279 S3G 
session. Proceed according to the 
instructions in Chapters 3 and 4. 


If you want to return to the E78 
session, press the hot key to exit the 
GRAPH session and return to DOS. If 
you made E78 resident, press the hot 
key again to return to the session. If 
you did not make E78 resident, execute 
the CE78 command. 
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STEP 8: When you are ready to quit, be sure you 
log off both sessions before you turn 
off the PC. 


Special Considerations for Using 
E78 with the Upgrade Hardware 


When you use the upgrade hardware, you are using 
prom-based IRMA hardware and RAM-loaded 
IRMA 3279 Graphics hardware. Because of these 
hardware differences, you may experience 
difficulty running third-party software and other 
E78-compatible applications after using the 
GRAPH emulator and switching to E78 (via the 
hot key and/or the startup command). If you are 
having difficulty switching from GRAPH 
emulation to E78 without rebooting, you can use 
the "native mode" function, which returns the 
IRMA hardware to its prom-based mode. 


To use native mode, press the <Esc> key anytime 
during a graphics emulation session. The 
following extended functions prompt (see Chapter 
4) displays with the additional native mode option: 


a)ppend c)apture e)xit p)rint r)esident N)ative t)est r)ecall ESC to cancel 
To access native mode, type: 
n <Enter> 


This exits the GRAPH emulator, ends the session 
with the host computer, and returns the hardware 
to prom-based mode. Now you can start E78 and 
run the desired programs. 
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Making E78 Resident 





CAUTION: Do not make the E78 emulator and 
the GRAPH emulator resident at the 
same time as results are 
unpredictable. 


If you plan to frequently switch between a DOS 
application program and a host session, you might 
want to make E78 resident in memory. With the 
resident emulator, you can press the hot key 
(<Shift><Shift>) to switch back and forth between 
DOS and emulation. The resident E78 emulator 
occupies 96 kilobytes of Random Access Memory 
(RAM). 


To make E78 resident, press the following key 
sequence during a host session: 


<Ctrl><Home> 


A prompt informs you that E78 is becoming 
resident. Press <Esc> to continue. After you press 
<Esc> you return to DOS. Press the hot key to 
return to the session. The E78 emulator software 
remains in the PC’s memory until you reboot the 
PC: 


NOTE: The control and print screen 
functions cannot be initiated from 
the resident E78 emulator. See the 
IRMA documentation for details. 
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Using the Keyboard Macro Driver, 
KMACDRV.SYS 


Creating Macros 





The KMACDRVSSYS keyboard driver that you put 
in your CONFIGSYS file in Chapter 2, lets you 
assign multiple keystrokes to a single key or key 
combination (a macro key). Macros are convenient 
for often-used words and phrases, embedded 
commands, filenames, addresses, etc. To create a 
key macro, use the Alternate <Alt> key and the 
plus <+> key on the numeric keypad as described 
in the following steps. Be sure to read the 
guidelines that follow these steps before actually 
creating macros. 


NOTE: The KMACDRYV.SYS file must be 
included in the CONFIGSYS file as 
described in Chapter 2 in order to use 
the <Alt><+> procedure. 


STEP 1: At the DOS prompt, press the <Alt> 
key, and while holding it down, press 
the <+> (plus) key on the NUMERIC 
KEYPAD. (The PC will beep once.) 


STEP-2: Press the key or key combination to be 
defined. 


STEP 3: Press the <Alt><+> key combination 
again. Remember to use the "+" on the 
Numeric Keypad. (The PC beeps 
twice.) 
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STEP 4: Press the new key definition. This may 
be a single key or a series of 
keystrokes. 


STEP 5: Press <Alt><+>. (The PC beeps three 
times.) 


The key definition procedure is complete. Now, 
each time you press the key defined in STEP 2, the 
new value you entered displays or the command or 
series of commands executes. To change a macro, 
repeat STEPS 1-5, pressing the same key in STEP 
2, but assigning a new definition in STEP 4. If 
you want to create other macros, repeat the 
<Alt><+> procedure. 


Follow these guidelines when redefining keys: 


o Do not assign new definitions to the <Ctrl>, 
<Alt>, <Caps Lock>, and <Shift> keys or any 
other keys that have similar specific functions. 


o Do not assign a new definition to the shift of 
keys that emit a character in the shift position. 
For example, if you assign a definition to the 
shift of "a," you lose the uppercase "A." 


o Do not assign a definition to any position of 
the function keys, <Fl> through <F10>. 


o When assigning macros to PF keys, we 
recommend that you do not redefine PFI-PF12, 
leaving them available for any host defined 
functions. Instead, assign functions to PF13- 
PF24. 


o You can assign a definition to any position -- 
<Alt><Shift>, <Ctrl><Alt>, <Ctrl><Shift>, etc. -- 
of a key that does not emit a character or 
perform a specific function. 





Chapter 6 - Using the Keyboard Macro Driver, 
KMACDRV.SYS 





The macros you define remain in memory until 
you reboot the PC. To clear macros without 
rebooting or to save macros into a file, see the 
following sections. 


Saving Macros in a File 


After you have defined one or more keys using the 
<Alt><+> procedure, you can save the key macros 
to a disk file using a program labelled "SKSAVE." 
The SKSAVE program assigns a .KMC extension to 
the file. 


To save a macro file on your working disk or hard 
disk simply type, 


SKSAVE filename <Enter> 


where filename is any name you wish to assign to 
the macro file following DOS filenaming 
conventions. You do not need to type an 
extension, as SKSAVE will automatically assign a 
-KMC extension. 


Note that a key macro file uses 4 Kbytes of disk 
space. If you want to save file on an additional 
diskette, specify the destination drive x with the 
SKSAVE command: 


SKSAVE x. filename <Enter> 
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Example 1: Creating and Saving 
Key Macros 





Following is an example of how to create and save 
a key macro. For this example, assume that you 
are using a word processing program that requires 
you to type the following embedded commands at 
the beginning of every paragraph: 


<bb=I> 
<fo=4> 


You want to create a macro that will produce 
these commands when pressed. The following steps 
assign these commands to the <Ctrl> position of 
the <l> key on the top row of the keyboard. 


STEP 1: Press the <Alt><+> key combination. 
(The keyboard emits one beep.) 


STEP 2: Press <Ctrl><1>, the key sequence to be 
defined. 


STEP 3: Press <Alt><+> (two beeps). 


STEP 4: Now, enter the keystrokes that you 
want to assign to the <Ctrl><I> 
sequence. For this example, we are 
assigning <bb=1> with a carriage return 
and <fo=4> with a carriage return. 
Type the first part of the definition: 


<bb=l> <Enter> 


Note that pressing the <Enter> (or 
carriage return) key presents <bb=I> as 
a command to DOS. Just ignore the 
"Bad command or file name" message 
that displays. This message has no 
effect on the macro definition 
procedure. 
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STEP 35: When the DOS prompt returns, type the 
second part of the definition: 


<fo=4> <Enter> 


Again, you can ignore the DOS "Bad 
command..." message. 


STEP 6: When the DOS prompt returns, press 
<Alt><+> to complete the key definition 
procedure (three beeps). 


STEP 7: To make sure that your definition is 
correctly recorded, press the <Ctrl><1> 
key sequence. (The information you 
assigned will try to execute in the same 
way it did during the <Alt><+> 
procedure.) If the key emits something 
other than 


<bb=I1> 
<fo=4> 


repeat STEPS 1-6. 


STEP 8: If you want to create any other key 
macros, do so now, repeating steps 1-7. 


STEP 9: To save the macros in a file, we will 
use SKSAVE. We will call the file 
created in this example, "NEWKEYS." 
The correct SKSAVE command line 
looks like the following: 


SKSAVE NEWKEYS <Enter> 
The key macro file "NEWKEYS" is 


saved to disk and given a .KMC 
extension: NEWKEYS.KMC. 
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Clearing Current Macros 





The macros you define remain in memory until 
your reboot the PC or clear the memory. If you 
reboot or clear without saving the files, the macros 
will be lost. A single macro can be cleared by 
pressing <Alt><+> (1 beep), the input macro 
sequence, <Alt><+> (2 beeps), <Alt><+> (3 beeps). 
For example, to remove the macro created in 
Example 1 above, press: 


<Alt><+> (1 beep) 
<Ctrl><I1> 

<Alt><+> (2 beeps) 
<Alt><+> (3 beeps) 


Press <Ctrl><l> and note that the previous 


All currently active macros can be cleared by 
pressing the <Alt><+> key sequence 3 times. These 
macros are lost unless they have been previously 
saved to a file with the SKSAVE command. 


Loading Key Macro Files 


io Sere et et ta eae 
The SKLOAD program allows you to load any key 
macro file that has a .KMC extension. To load a 


key macro file, type the following command at the 
DOS prompt, 


SKLOAD filename <Enter> 


where filename is the name of the macro file you 
want to load. You don’t need to type the 
extension. 
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Using the SK Program 





Typically, to use a key macro file with an 
application program, you have to perform 3 steps. 
You must 1) boot the PC from your hard disk or 
Keyboard Utilities diskette to load the keyboard 
drivers 2) load your .KMC file with SKLOAD, and 
3) execute the application. The SK program 
combines steps 2 and 3, loading the custom .KMC 
file and executing the application program with a 
single command. 


The format for the SK command is, 
SK[/V][/P] Programname 


where "SK" saves the current macro file if one 
exists, loads a new macro file that must bear the 
Same name as the program, and executes the 
program. 


The operand "/V" turns on a Verbose mode that 
displays messages about program operation and 
asks "Are you sure?" questions where appropriate. 


The operand "/P" tells SK to Preserve any changes 
you make to the key macro file while you are 
using the program. When you exit the program, 
the changes are saved in the .KMC file with which 
you started the program. 


Programname is the command used to execute the 
PC application program. The name of your key 
macro file must match the command to start the 
program. 


NOTE: If you make changes to a key macro file 
while running an application program, 
but you haven’t specified /P, SK will ask 
you if you wish to save the changes. If 
you answer "No," the changes are 
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discarded and the original keyboard is 
restored. 


The following steps give instructions for using the 
SK program. Thoroughly read these guidelines 
before you attempt to use the SK program. 


STEP 1: Boot the PC from your hard disk or 
Keyboard Utilities diskette. 


STEP 2: Create and save a key macro file with 
<Alt><+> and SKLOAD. The name you 
assign to the macro file must match the 
command to execute the application 
program. For example, "WS" is the 
command to start WordStar, so your 
macro file must be named "WS.K MC." 


STEP 3: Copy the SK program, SK.EXE and the 
custom macro file from the program 
disk to the PC application disk. 


STEP 4: To execute the application program 
with the custom macro file, type, 


LX:ISK/V/P Programname 


where X 1s the drive containing the 
application program (if other than the 
current drive) and Programname is the 
command to execute the application as 
well as the name of the custom .KMC 
file. 


NOTE: When you exit the application program, 
SK restores the macro file in effect 
before the application was executed. 


To automatically load the application program and 
its custom keyboard profile at boot time, place the 
SK command line in an AUTOEXEC.BAT file on 
your program disk. Use the editing program of 
your choice to insert the following line: 


eos 
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X:SK/V/P Programname 


where X: is the drive containing the PC application 
program. 


When you boot the PC from your working disk or 
hard disk, the PC loads the keyboard drivers first, 
and then reads the AUTOEXEC.BAT file and 
defaults to drive X, where the SK program and 
your custom .KMC file load automatically and the 
application program starts. 
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Chapter 7 


Remapping the Keyboard 


Introduction 


The KYBDDRV.SYS keyboard driver, placed in 
the CONFIG.SYS file in Chapter 2, allows you to 
use a special remapping program labelled 
KYBDEDIT. KYBDEDIT lets you create alternate 
keyboard profiles by changing, swapping, or 
duplicating key codes. Because KYBDEDIT alters 
the key code, the slightest error may make your 
keyboard unrecognizable. Thus, we recommend 
using the <Alt><+> procedure described in Chapter 
6 for making most all keyboard changes. 
Programmers requiring major keyboard 
modifications are the intended audience for 
KYBDEDIT. 


NOTE: In order to use KYBDEDIT, the 
KYBDDRYV.SYS driver must be placed in 
the CONFIG.SYS file on your working 
disk or hard disk with the appropriate 
parameters. See Chapter 2 for complete 
instructions. 
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Using KYBDEDIT 





The KYBDEDIT program and the GraphPac 
remapping program primarily serve the same 
function: they both allow major keyboard 
remapping. If you have previously used one of 
these programs, you should continue to use the 
program that is familiar to you. (GraphPac 
remapping is described in Appendix F). If you 
have never used either program, you should first 
try to use the <Alt><+> procedure in Chapter 6 to 

- create macros. Then if you need more extensive 
remapping, you can try KYBDEDIT. Using 
KYBDEDIT requires extensive knowledge of the 
IBM BIOS routine and IBM 3270 character codes. 
Don’t use KYBDEDIT unless you are thoroughly 
familiar with the BIOS routine. 


Starting KYBDEDIT 


Execute the KYBDEDIT program from your hard 
disk or program diskette by typing: 


KYBDEDIT <Enter> 


The following screen displays when any keyboard 
other than the IBM 101/102 key keyboard is used: 
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Initial KYBDEDIT Screen: Standard PC Keyboard 


KYBDEDIT -- Sade cid baal Layout Editor | 
Revision x.xx Copyright 1987, Digital Communications Associates, Inc. 


Keyboard File Name 


Description 
1 Read |2 Help 
7s |8Nxt Val 


The following screen displays if you are using a 
101/102 key keyboard. 










W 


OTN 


Initial KYBDEDIT Screen: Enhanced PC 
Keyboard 


eet KYBDEDIT -- Extended Keyboard Layout Editor | 
Revision x.xx Copyright 1986, 1987, Digital Communications Associates, Inc. 
Keyboard File Name 


Description 


1 2 3 4 5 6 7 8 9 10 11 12 
Read jHelp |Edit Save |Erase Next | [Exit |jReset 
EOF Value 


To select an option, press the function key, <F1> 
through <F10>, that corresponds with the option. 
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For example, to select "Help," press the <F2> key. 
The even numbered options are found on all 
screens, while the odd numbered options vary from 
screen to screen. The five common options are 
described below. 


KYBDEDIT: Common Options 


Option 


Help 


Ers EOF 


Nxt Val 


Exit 


Reset 


NOTE: 


Access 
Key 


<F2> 


<F6> 


<F8&> 


<F9> 


<F10> 


Description 


Displays help 
information for the 
current task. 


Erases characters to the 
right of the cursor. 


Displays the next valid 
value of a field, if there 
is one. 


Returns you to the 
previous screen. If you 
press this key at the first 
screen, you return to 
DOS. 


Clears any input error 
messages on the screen. 


To display help information for the 
first field of a menu, press <F2> (Help) 
while in the first field. To display help 
files for other fields, press <F10> 
(Reset) to leave the help file, press 
<F1l>, (Change) to reach the next field 
and then press <F2> (Help). Use the 
tab key to reach remaining fields. 
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After you have pressed the <Fl1> 
(Change) key, exercise caution to avoid 
accidentally changing a key. 


Creating a Keyboard Profile 


To edit or create a keyboard profile, follow these 


steps. 


STEP 1: 


STEP 2: 


STEP 3: 


STEP 4: 


Start KYBDEDIT as described earlier. 


In the "Keyboard File Name" field, type 
the name of the file you want to edit 
or create. You don’t need to type an 
extension, as KYBDEDIT assumes (or 
assigns) a .K YB extension. 


If you are creating a new file, skip this 
step. If you are editing an existing 
file, press <Fl> (Read). The contents 
of this profile are read into memory. 


Press <F3> to display one of the 
following editing screens: 
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Editing Options Screen: Standard PC Keyboard 


KYBDEDIT -- pprereaneyeodie Layout Editor _ 
Revision x.xx Copyright 1987, Digital Communications Associates, Inc. 





Editing Options Screen: Enhanced PC Keyboard 
KYBDEDIT -- Extended Keyboard Layout Editor | 
Revision x.xx Copyright 1986, 1987, Digital Communications Associates, Inc. 
Keyboard filename Sample 


Description 


1 2 3 4 P) 6 7 8 9 10 11 12 


Codes Xchg Copy jErase Next Exit |Reset 
EOF Value 


The screen now contains four options. From the 
descriptions below, choose an option by pressing its | 
access key. Then read the following sections for | 
information on using each option. 
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KYBDEDIT: Editing Options 


Editing Access 
Option Key Description 


Codes <Fl> Lets you modify the 
character codes sent from 
the keyboard to the BIOS 





when a given key is pressed. 
Use this screen only if you 


are an experienced 
programmer. 


Xchg <F3> Allows you to exchange the 


position of two keys, 
including all special keys 
such as Shift, Caps Lock, 


and Insert. 
Copy <F5> Lets you duplicate keys. 
Modes <F7> Gives you control over four 


basic keyboard features: 


print screen, typewriter shift 


lock, key clicker, and one- 
finger shifts. 


Using the Codes Option 


The Codes option is intended only for technicall 
proficient programmers who require major 


Md 


keyboard alterations. You can make most of your 
keyboard changes with the Copy and Xchg options 


which are easier to use and are explained in the 
following sections. 
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CAUTION:Severe program malfunction will result 
from incorrectly entering data in the 
Codes menu. Do not attempt to use the 
Codes option unless you have a 
thorough understanding of the IBM 
3270 character codes. 


If you are going to use the Codes option, carefully 
study the information regarding keyboard 
encoding, keyboard values, character codes, etc. 
found in the IBM PC Technical Reference. You 
Should have a clear understanding of how this 
information is used by the PC BIOS before using 
the Codes option. 


To display the Codes screen, press the <FI> key. 
One of the following screens displays: 
KYBDEDIT Codes Screen: Standard PC Keyboard 


_. KYBDEDIT -- BAces ne yoedta Layout Editor | 
Revision x.xx Copyright 1987, Digital Communications Associates, Inc. 


Key Position Number 0 










Key Name Key Tag 
Shift Lock Type None Auto Repeat No SysReq No 
No Key Break (release)? No 101 Duplicate? No 
1 Change |2 Help High Low Display 
3 Next {4 Normal (Unshifted) . Key Value 
Shift Upper Case) Key Value 
5s: |6Ers EOF cpntke CTRL)... ay Va ue 
7Dead Ky|8Nxt Val Co rot-alt mde eee Key Value 
; CPAtLo -Shift Key Value 
9 Exit A NVEE ek EE Key Value 
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KYBDEDIT Codes Screen: Enhanced PC Keyboard 


; KYBDEDIT -- Extended Keyboard Layout Editor _ 
Revision x.xx Copyright 1986, 1987, Digital Communications Associates, Inc. 


Key Position Number 0 


Key Name Key Tag 
Shift Lock Type None Auto Repeat No SysReq No 
No Key Break (release)? No 101 Duplicate? 
High Low’ Display 
Normal (Unshifted) . Key Value 0 (O ) 
Shifted rate Case) Key Value 0 (O ) 
Control (CTRL) . . . Key Value 0 (oO ) 
BUC eee se see oe tO Key Value 0 (O ) 
Control-Alt .. . . Key Value 0 (oO ) 
Control-Shift .. . Key Value 0 (0 ) 
AlLE-SHITE Soe aw 6 Key Value 0 (oO ) 
2 3 4 5 6 7 8 9 10 11 12 


The following fields are displayed on the Codes 
menu: 


KYBDEDIT: Codes Menu Options 


Field Description 
Key Position Position number of key to be 
Number modified. (Position numbers are 


located at the end of this chapter. 
Key Name Description of the primary 


function or action of the key. 
Maximum 28 characters. 
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KYBDEDIT: Codes Menu Options (continued ) 


Field 


Key Tag 


Shift Lock 
Type 


Auto Repeat 


Sys Req 


No Key Break 
Release 


Description 


Short form description of the key 
function--maximum 4 characters. 


Lock type, if any, on this key. 
Press <F8>, "Nxt Val" for lock 
types. Types are: 


CAPS--Caps lock shifts key to 
upper-case mode. 


NONE--No locks. 


NUM--Num lock moves key to 
numeric (shifted) mode. 


When ON, allows key to repeat 
when held down. 


Parameter used by the 
KYBDDRV.SYS keyboard driver 
to determine the location of the 
AT’s SYSREQ key. Note that the 
AT’s SYSREQ key does not 
perform the same function as the 
3270 SYS RQ. 


KYBDDRVSSYS processes 
information in the field to 
determine if a key’s break code 
should be expected by the driver. 
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KYBDEDIT: Codes Menu Options (continued ) 


Field Description 


101 Duplicate? Enhances processing of the 
101/102 key keyboard. The valid 
options are 


NO Specifies that the key is 
not duplicated on the 
101/102 keyboard. 
Duplicate keys include 
the extra keypad keys: 
Insert, Delete, Home, 
End, Page Up, Page 
Down; the new cursor 
keys; and the Numeric 
Pad Slash. 


RmvShf Removes the upper case 
shift state on keys 
duplicated by the extra 
(or "alpha") key pad. 
Thus, when Num Lock is 
ON, only the numeric 
keypad is affected. 


AddShf Intended for 
international users; 
ignore this option. 


High Controls high part of BIOS key 
code sent to a program when the 
key is pressed. Range is 0-255 
(usually the same as the Key 
Position Number). Value of 250- 
255 indicates a special action key. 
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KYBDEDIT: Codes Menu Options (continued) 


Field 


Low 


Display 


Description 


Controls low part of BIOS key 
code sent to a program when the 
key is pressed (usually the PC 
extended ASCII character code or 
zero if the key is a function key 
Or numeric pad cursor control 
key). Range is 0-255. To 
determine these values, see the 
tables at the end of this chapter. 


Shows how the BIOS key code is 
displayed in a document or in the 
PC display. 


To modify a key with the Codes option, follow the 
steps below. 


STEP 1: 


STEP 2: 


STEP 3: 


Fill in the key position number of the 
key you want to modify. Press <Enter> 
to display the corresponding values for 
that key under the High, Low, and 
Display headings. 


Press <Fl> (Change) to move to the 
next field and fill in the value. Tab to 
reach the remaining fields. Fill in the 
new values the key will have under the 
High, Low, and Display headings. You 
can find this information in the tables 
at the end of this chapter. You can 
also display key values by pressing 
<F3> (Next). 


After filling in the appropriate values 
for the key modification, return the 
cursor to the "Key Position Number" 
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field. If you want to alter other keys, 
repeat the procedure. 


STEP 4: When finished, press <F9> (Exit) twice 
to return to the main KYBDEDIT 
screen, and press <F5> (Save) to save 
the alterations in a profile. To load 
profiles, see the section entitled 
‘Loading Keyboard Profiles’ in this 
chapter. 


NOTE: The "Dead Key" option selected by pressing 
<F7>, is a feature for international users. 
Using the Xchg Option 
To display the Xchg (exchange) menu, press <F3>. 
One of the following screens is returned: 
Exchange Screen: Standard PC Keyboard 


KYBDEDIT -- Extended bee Layout Editor _ 
Revision x.xx Copyright 1987, Digital Communications Associates, Inc. 
Source Key Number 0 Description 


Exchange with Key 0 Description 


fr xchnge [2 Help 
ele 


7 |anxt val 
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Exchange Screen: Enhanced PC Keyboard 


KYBDEDIT -- Extended Keyboard Layout Editor | 
Revision x.xx Copyright 1986, 1987, Digital Communications Associates, Inc. 


Source Key Number 0 Description 
Exchange with Key 0 Description 
1 2 3 4 5 6 7 8 9 10 11 12 


Xchng jHelp Erase Next Exit |Reset 
Keys EOF Value 


To exchange or swap the positions of two keys, 
follow these steps: 


STEP 1: In the "Source Key Number" field, enter 
the key position number of one of the 
keys you want to exchange. (For key 
position numbers, see the tables at the 
end of this chapter.) Press the tab key 
to move to the next field and note that 
the description of the source key is 
displayed. 


STEP 2: In the "Exchange With Key" field, enter 
the key position number of the key to 
be exchanged with the previous key. 
Press the tab key and note that the 
"exchange" key description is displayed. 


STEP 3: Press <Fl> (Change). If you want to 
make other exchanges, repeat the 
procedure. 


STEP 4: When you have finished making 
changes, press <F9> (Exit). 
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STEP 5: Press <F9> again to return to the 
original KYBDEDIT screen. 


STEP 6: Press <F5> (Save). KYBDEDIT will 
give the profile a .K YB extension. 


STEP 7: To verify your change, press <F9> 
again to return to DOS and load the 
profile using the commands discussed in 
the section of this chapter entitled 
‘Loading Keyboard Profiles.’ 


Using the Copy Option 
To display the Copy menu, press the <F5> key. 
The following screen displays: 
KYBDEDIT Copy Screen: Standard PC Keyboard 


a KYBDEDIT -- AS ak ccna eral Layout Editor | 
Revision x.xx Copyright 1987, Digital Communications Associates, Inc. 


Source Key Number 0 Description 


Destination Key Number 0 Description 








ae 


Chapter 7 - Remapping the Keyboard 





KYBDEDIT Copy Screen: Enhanced PC Keyboard 


KYBDEDIT -- Extended Keyboard Layout Editor 


Revision x.xx Copyright 1986, 1987, Digital Communications Associates, Inc. 


Source Key Number 0 Description 
Destination Key Number 0 Description 
1 2 3 4 5 6 7 8 9 10 11 12 


fe) Hel Erase Next Exit |Reset 


To make one key the duplicate of another, follow 


these steps: 


STEP I: 


STEP 2: 


STEP 3: 


In the "Source Key Number" field, enter 
the key position number of the key you 
wish to copy. (Key position numbers 
are listed at the end of this chapter.) 
Press the tab key to move to the next 
field and note that the source key 
description is displayed. 


In the "Destination Key Number" field, 
enter the position number of the key 
that is to be the duplicate of the source 
key. Press the tab key and note that 
the destination key description is 
displayed. 


Press <Fl> (Change). Note that the 
destination key description is now the 
same as the source Key description, 
indicating that the copy has been 
recorded. If you want to make other 


STEP 4: 


STEP 35: 


STEP 6: 
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duplicates, repeat the procedure, being 
careful to press <Fl> (Change) each 
time after entering the destination key 
number. 


When you finish assigning the duplicate 
keys, press <F9> (Exit) twice to return 
to the first KYBDEDIT screen. 


Press <F5> (Save). 


To verify your copy, press <F9> to 
return to DOS, load the profile using 
the KYBDLOAD command discussed in 
‘Loading Keyboard Profiles,’ and check 
the keys you copied. 


Chapter 7 - Remapping the Keyboard 





Using the Modes Option 


The modes option lets you specify keyboard 
features for a single profile. (Most of these 
features can also be activated by switches, 

described at the beginning of this chapter.) 


To display the Modes menu, press <F7> from the 
KYBDEDIT editing screen. One of the following 
menus displays: 


KYBDEDIT Modes Screen: Standard PC Keyboard 


— KYBDEDIT -- ee ee ee Layout Editor | 
Revision x.xx Copyright 1987, Digital Communications Associates, Inc. 


1st Key Repeat 
Print Screen Key _ Yes Key Clicker Yes No 
Typewriter Shift Lock No One Finger Shifts No 
International No Alt Gr key shift type None 
101 Duplicate Shift None 
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KYBDEDIT Modes Screen: Enhanced PC Keyboard 


; KYBDEDIT -- Extended Keyboard Layout Editor | 
Revision x.xx Copyright 1986, 1987, Digital Communications Associates, Inc. 


Ist Key Repeat 
Print Screen Key Yes Key Clicker Yes No 
Typewriter Shift Lock No One Finger Shifts No 
International No Alt Gr key shift type None 
101 Duplicate Shift None 
1 2 3 4 5 6 7 8 9 10 11 12 


Erase Next Exit jReset 
EOF Value 


The following fields are found on the modes menu. 
Options for all fields are YES and NO to enable or 
disable, respectively. Use the tab key to move 
from one field to the next. Within each field, 
press <F8>, "Nxt Val" to display the opposite value. 


KYBDEDIT: Modes Menu Fields 


Field Description 
Print Screen Enables or disables the print 
Key screen key. Users with no printer 


attached to the PC printer port 
may wish to disable, since the PC 
may "hang up" when the key is 
pushed with no printer available. 
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KYBDEDIT: Modes Menu Fields (continued ) 


Field 


Key Clicker 


Typewriter 
Shift Lock 


One-Finger 
Shifts 


International 


Alt Gr key 
shift type 


Description 


Enables or disables the key click 
sound for a key the first time it is 
pressed (Ist Key), and when held 
(Repeat). 


For example, if you answer yes to 
Ist Key and no to Repeat, all keys 
on your keyboard click the first 
time they are pressed. If you 
have specified automatic key 
repeat (see Chapter 2), a key 
clicks the first time it is pressed 
but does not click when held. 


Enables or disables the 
typewriter-style shift lock. An 
enabled PC CAPS lock key works 
in a manner similar to that of a 
typewriter shift lock. 


Enables or disables the one- 
finger shift feature which causes 
the shift keys to "stay pressed" 
until a character key is pressed. 


(Intended for international users; 


ignore this field.) 


(Intended for international users; 
ignore this field.) 
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KYBDEDIT: Modes Menu Fields (continued ) 


Field Description 


101 duplicate 
shift (Intended for international users; 
ignore this field.) 


For more information pertaining to any field on 
the Modes menu, tab to the field and press <F2> 
for help. 


Loading Keyboard Profiles 


Once you have allocated memory for alternate 
profiles (see the switches at the beginning of this 
chapter), you can load them into random access 
Memory with the KYBDLOAD program. The 
command for loading a keyboard profile is as 
follows: 


KYBDLOAD/S=n/A filename <Enter> 


This command line loads the profile that you 
insert in place of filename into memory slot n 
where n is a number from | to 9. (Memory slot "0" 
is always occupied by the standard profile, 

USA.K YB, which is automatically loaded at 
Startup.) The /A flag activates the profile. 


For example, to load a profile labelled 
"PCDOS.K YB" type, 


KYBDLOAD/S=1/A PCDOS 
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where 
1 -41is the memory slot location for PCDOS 


/A-is a flag that activates the PCDOS profile. 


Activating Profiles 


Up to nine different profiles can be placed in 
memory at one time, as long as sufficient memory 
has been allocated with the driver in the 
CONFIGSSYS file (see "Using Keyboard Switches" 
in Chapter 2). Because only one profile can be 
active at boot time, you must omit the /A flag 
when loading additional profiles with 
KYBDLOAD. To activate an alternate profile or 
to switch back and forth among profiles, press the 
following key sequence: 


<Ctrl><Alt><Fx> 
where "Fx" is a function key (F1-F10) that selects 
the profile assigned to a specific memory slot. 


Activate or swap profiles by using the key 
sequences given in the following table. 
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Table 7-1: Key Sequences for 
Activating Alternate Keyboard Profiles 


Key Sequence Profile Location 


Ctrl-Alt-F1 Activates the DCA standard profile, 
USA.K YB, in memory slot 0 

Ctrl-Alt-F2 Activates profile in memory slot 1 
Ctrl-Alt-F3 Activates profile 1n memory slot 2 
Ctrl-Alt-F4 Activates profile in memory slot 3 
Ctrl-Alt-F5 Activates profile in memory slot 4 
Ctrl-Alt-F6 Activates profile in memory slot 5 
Ctrl-Alt-F7 Activates profile in memory slot 6 
Ctrl-Alt-F8 Activates profile in memory slot 7 
Ctrl-Alt-F9 Activates profile in memory slot 8 
Ctrl-Alt-Fl10 Activates profile in memory slot 9 


Key Position Numbers 





The following table lists key position numbers 
required by the Codes, Xchg, and Copy editing 
options of the KYBDEDIT program. The other 
tables supply more detailed information about 
Standard and special key values. 


NOTE: Where there are two characters listed 
under the "unshifted" or "shifted" column, 
the first character is generated in PC 
mode and the second is generated in 3270 
emulation. 
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Table 7-2: Key Position Numbers 


Key KEYCAP LABEL (UNSHIFTED) 


Position 
Numbers PC, PC AT IRMAkey 101/102 

] Esc Esc Esc 
2 l 1 ] 

3 2 2 p) 

4 3 3 3 

5 4 4 4 

6 5 5 5 

7 6 6 6 

8 7 7 7 

9 8 8 8 
10 9 9 9 

1] 0 0 0 
12 - - - 

13 = mo = 
14 Back Space Back Space Back Space 
15 Tab Tab Tab 
16 q q q 
17 Ww Ww WwW 
18 c € e 
19 r r r 
20 t t t 

2] y y y 
22 u u u 
23 1 i i 

24 O O O 
25 p p p 
26 [ [ [ 

27 

28 CR CR CR 
29 Ctrl Ctrl Ctrl 
30 a a a 
3] S S S 

32 d d d 
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Table 7-2: Key Position Numbers (continued ) 


Key 
Position 
Numbers 


33 
34 
35 
36 
37 
38 
39 
40 
4] 
42 
43 
44 
45 
46 
47 
48 
49 
50 
5] 
52 
53 
54 
55 


KEYCAP LABEL (UNSHIFTED) 


PC, PC AT IRMAkKey 101/102 


het ee EH GTQ 
coe ele GQ A 
tee ES GQ Hh 


wwe 


>) 
9 


wwe 


Left Shift Left Shift Left Shift 


Spo KO KN 
Be ocdOxN— 
Bp oO KN 


ws 
° td 
we 


Right Shift Right Shift Right Shift 
* * x 


Alt Alt Alt 
Space Bar Space Bar Space Bar 
Caps Lock Caps Lock Caps Lock 
Fl Fl Fl 
F2 F2 F2 
F3 F3 F3 
F4 F4 F4 
F5 F5 F5 
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Position 
Numbers 
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Key 


64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
719 


KEYCAP LABEL (UNSHIFTED) 


PC, PC AT 


F6 

F7 

F8 

F9 

F10 
NumLk 
ScrLk 
Num Pad 7 
Num Pad 8 
Num Pad 9 
Num Pad - 
Num Pad 4 
Num Pad 5 
Num Pad 6 
Num Pad + 
Num Pad 1 
Num Pad 2 
Num Pad 3 
Num Pad 0 
Num Pad 
SYSREQ 
N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 


IRMAkey 


F6 

F7 

F8 

F9 

F10 
NumLk 
ScrLk 
Num Pad 7 
Num Pad 8 
Num Pad 9 
Num Pad - 
Num Pad 4 
Num Pad 5 
Num Pad 6 
Num Pad + 
Num Pad 1 
Num Pad 2 
Num Pad 3 
Num Pad 0 
Num Pad 
PFl 

PF2 

PF3 

PF4 

PF5 

PF6 

PF7 

PF8& 

PF9 

PF10 

PF1l 

PF12 


Table 7-2: Key Position Numbers (continued ) 


101/102 


F6 

F7 

F8 

F9 

F10 
NumLk 
SerLk 
Num Pad 7 
Num Pad 8 
Num Pad 9 
Num Pad - 
Num Pad 4 
Num Pad 5 
Num Pad 6 
Num Pad + 
Num Pad 1 
Num Pad 2 
Num Pad 3 
Num Pad 0 
Num Pad 
SYSREQ 
N/A 

N/A 

Fill 

F12 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 


aS 


Key 
Position 
Numbers 


96 

97 

98 

99 

100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
Li] 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 


KEYCAP LABEL (UNSHIFTED) 


PC, PC AT 


N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 


IRMAkey 


PF13 
PF14 
PF15 
PF16 
PF17 
PF18 
PF19 
PF20 
PF21 
PF22 
PF23 
PF24 
< 


RESET 
ENTER 


DUP 
FM 


Back Tab 


INS 
DEL 


DCAI1 

UP CURSOR 
DCA2 

LEFT ARROW 
HOME/RULE 
RIGHT CURSOR 
DCA3 

DOWN CURSOR 
DCA4 

Num Pad = 

Num Pad Tab 
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Table 7-2: Key Position Numbers (continued ) 


101/102 


N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
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BIOS Key Code Information 





The Basic Input/Output System (BIOS) key codes 
generated by the driver KYBDDRV.SYS may be 
classified by function. The BIOS returns the 
following three major types of key code: 


1. Standard PC pseudo-ASCII characters. These 
are characterized by an ASCII character in the 
low byte of the returned BIOS key code and 
the key scan code in the high byte. 


2. PC Function keys. Function keys are marked 
by a BIOS code which has a zero low byte. 
The function number if returned as a value 
from zero through 255 in the high byte. 


3. 3270 Extended function codes. These codes 
contain a function number in the low byte 
and an extended scan code value in the high 
byte. Extended scan codes are 128 through 
191. 


To classify the codes, use the following procedure: 


STEP 1: Check for a standard PC function key 
by comparing the low byte of the BIOS 
key code with zero. If the low byte is 
zero, the key is a function key and its 
function code is in the high byte. 


STEP 2: Check for standard PC pseudo-ASCII 
characters. Compare the high byte of 
the BIOS scan code with 128. If the 
scan code is less than 128, the keystroke 
is a standard PC ASCII character 
keystroke. 


STEP 3: Any keys not in the previously listed 
groups are one of the following 3270 
extended character codes: 
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a. 3270 PF keys. These keys have 





a 


scan code of 128 and a low byte 
arranged in ascending order first 


by scan code, then shift state. 


b. 3270 PC Extension keys. These 


keys have a scan code of 129 and 
are grouped in a fashion similar to 


that of the PF keys described 
above. 


c. Standard PC Expansions. These 
key codes fill in the "holes" in the 
existing PC keyboard layout. Scan 
codes reserved for these keys are 


130 through 133. The low byte 
each of these codes is an ASCII 
character corresponding to the 


of 


uppercase or shifted value of the 
key. The following values are used 


to fill in the PC "holes". 


130 - Holes in Ctrl-XX domain. 


131 - Holes in Ctrl-Alt XX 
domain. 


132 - Holes in Ctrl-Shift XX 
domain. 


133 - Holes in Alt-Shift XX 
domain. 


The following tables list key codes for all states of 


the keys on the IRMAkey keyboard. 
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Key Value Tables Interpretation Guide 


Use the following "key" to interpret the 
information in the Key Value tables which follow. 


o "Key" is the decimal key scan code. 


o "Flag t" indicates that the key automatically 
repeats when held. This has no effect on shift 
keys and toggle keys. "C" indicates that CAPS 
LOCK acts on this key. "N" indicates that 
NUM LOCK acts on this key. 


o Key descriptions consisting of a number 
followed by a symbol indicate that the ASCII 
value of the symbol is returned with the given 
number in the high byte. 


o Key descriptions consisting of a number 
followed by "fky" indicate a function key 
which has the number in the high byte and a 
zero in the low byte. 


o Key descriptions consisting of a number 
followed by capital letters (e.g. 046 ETX) 
return the ASCII control character given (ETX) 
with the number in the high byte (46). 


o The insert key action, indicated by "082*fky," 


means that the insert state flag is toggled and 
the key code "082" is returned. 
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Table 7-3: Key Values 


Key Flags Name Normal Shift Control Alt Ctrl-Alt Ctrl-Shft Alt-Shft Description 

1 t Esc 001 ESC 001 ESC 134 ESC 001 fky  KeyPass 132 ESC 133 ESC Escape 

2 t 1 002 1 002 ! 134 ! 120 kyf 131 ! 132 ! 133! One/Exclamation 
35 t 2 003 2 003 @ 003 fky 121 fky 131 @ 132 @ 133 @ Two/Commercial At Sign 
4 t 3 004 3 004 # 134 # 122 fky 131 # 132 # 133 # Three/Pound Sign 
5 t 4 005 4 005 $ 134 $ 123 fky 131 §$ 132 $ 133 $ Four/Dollar Sign 
6 t 5 006 5 006 % 134 % 124 fky 131 % 132 % 133% Five/Percent 

v t 6 007 6 007 “* 007 RS 125 fky 131 % 132. = 3s ° Six/Upcarat/Logical Not 
8 t 7 008 7 008 & 134 & 126 fky 131 & 132 & 133 & Seven/Ampersand 
9 t 8 009 8 009 * 134 * 127 fky 131 * 132 * 133: * Eight/Asterisk 
10 t 9 010 9 010 ¢ 134 ¢ 128 fky 131 ¢ 132 ¢ 133 ¢ Nine/Left Paren 
11 it 0 011 0 011 ) 134 ) 29 fky 131) 132 ) 133) Zero/Right Paren 
Ve. °% _ 012 _ 012 _ 134 _ 130 fky 131 _ 132 133 Minus/Underscore 
13 tt = 013 = 013 + 134 + 131 fky 131 = 132 = 133 = Equal/PLus 

14 ¢t BS 014 BS 014 BS 014 RUB 140 fky 131 BS 132 BS 133 BS Backspace 

15 ¢t TAB O15 HT 015 fky 134 HT 015 fky 131 HT 132 HT 133 HT Tab/Back Tab 

16 tC Q 016 gq 016 Q 016 DC1 016 fky 131 Q 132 Q 133 Q Q 

17 — tC W 017 w 017 W 017 ETB O17 fky 131 W 132 W 133 W W 

18 tC E 018 e 018 E 018 ENQ 018 fky 131 €E 132 E 153° “E E 

19 tC R 019 Fr 019 R 019 DC2 019 fky 131 R 132 R 133. R R 

20 = tC T 020 ¢t 020 T 020 DC4 020 fky 131 T 132 T 133 T T 


pavoqkay ay} duiddemay - 1 1a}deyy 
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Table 7-3: Key Values (continued ) 


Key Flags Name Normal Shift Control Alt Ctrl-Alt Ctrl-Shft Alt-Shft Description 

21 tc Y 021 y O21 Y 021 EM 021 fky 131 Y 132 Y 1335 Y sf 

22 «tC U 022 U 022 U 022 NAK O22 fky 131 U 132 U 133 U U 

23. = tC I 023 1 023 I 023 HT 023 fky 131 I 132 I 133 I I 

24 tC 0 024 o 024 0O 024 $I 024 fky 131 O 132 0O 133 0 0 

25 tC Pp 025 p 025 P 025 DLE 025 fky 131 P 132 P 133. P P 

26 ¢t [ 026 [ 026 ¢ 026 ESC 026 fky 131 € 132 € 13353 Open Bracket/Brace 
27. lt ] 027 ] 027 } 027 GS 027 fky 131 } 132 } 133} Close Bracket/Brace 
28 «Ct RET 028 CR 028 CR 028 LF 028 fky 131 CR 132 CR 133 CR Return/New Line 

29 CTRL Control Control Control Control Control Control Control Control 


30.—=s tC A 030 a 030 A 030 SOH 030 fky 131 A 132 A 133 A A 


31 + tc S 031 s 031 S§ 031 DC3 031 fky 131 § 132 S$ 133 S S 

32 = tC D 032 d 032 D 032 EOT 032 fky 131 OD 132 D 133 D D 

35~=—s«étCC F 033 «f 003 F 033 ACK 033 fky 131 F 132 F 133. F F 

34 =tC G 034 g 034 G 034 BEL 034 fky 131 G 132 G 133 G G 

35 = tc H 035 h 035 4H 035 BS 035 fky 131 4H 132 4H 133 H H 

36 ~=—s tt J 036 j 036 J 036 LF 036 fky 131 J 132 J 133 J J 

37.—s tC K 037 k 037 K 037 VT 037 fky 131 K 132 K 133. K K 

38 =6tC L 038 l 038 L 038 FF 038 fky 131 L 132 L 133 OL L 

39 ~—Cl tt Fs 039 ; 039 : 134: 039 fky 131 : 132 : 133: Semicolon/Colon 

40 t ' 040 ! 040 "" 134 "" 040 fky 131" " 132 " u 133 "4 Single/Double Quote 
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ome 


Flags Name Normal 


et ct ct et 


SB 2zv<ceiagx nN ~ 


041 =! 
Shift 

043 \\ 
044 
045 
046 
047 
048 
049 
050 


3 50O< OO XN 


051 , 
052 . 
053 / 
Shift 
055 * 
Alt 

057 SP 
Caps Lk 
059 fky 
060 fky 


Table 7-3: Key Values (continued ) 


Shift 


014 ~ 
Shift 
043 
044 
045 
046 
047 
048 
049 
050 


Sz ewnaenox nN— 


051 < 
052 . 
053 ? 
Shift 
PrtSc 
Alt 

057 SP 
Caps Lk 
084 fky 
085 fky 


Control 


1354 ~ 
Shift 

045 FS 
044 SUB 
045 CAN 
046 ETX 
047 SYN 
048 STX 
049 SO 
050 CR 


134 < 
134 > 
134 ? 
Shift 
114 fky 
Alt 

134 SP 
Caps Lk 
094 fky 
095 fky 


Alt 


041 fky 
Shift 

043 fky 
044 fky 
045 fky 
046 fky 
047 fky 
048 fky 
049 fky 
050 fky 


051 fky 
052 fky 
053 fky 
Shift 
055 fky 
Alt 

057 fky 
Caps Lk 
104 fky 
105 fky 


Ctrl-Alt 


13) <= 
Shift 
131 
131 
131 
131 
131 
131 
131 
131 


zene x N 


131 
131 > 
131 ? 
Shift 
PrtEn 
Alt 
131 SP 
131 / 


Layout 0 


Layout 1 


Ctrl-Shft Alt-Shft 


loe -* 
Shift 
132 
132 
132 
132 
132 
132 
132 
132 


=z zwvnvceli ao x Ne 


132 < 
132 > 
132 ? 
Shift 
132 =! 
Alt 
132 SP 
132 
132 
132 


oo™N 


133. ~ 
Shift 
133 
133 
133 
133 
133 
133 
133 
133 


= zvoneox nN— 


133 < 
133 > 
133 ? 
Shift 
133! 
Alt 
133 SP 
133 / 
133 a 
133 b 


Description 


Accent/Tilde 
Left Shift Key 
Backslash/Vertical Bar 


Zzeewnwneno x MN 


Comma 

Period 

Slash/Question 

Right Shift Key 

Print Screen/Asterisk 
Alt 

Space 

CAPS Lock 

F1 

F2 
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Key 


Flags Name 


ce ct ct oct oct ct oct uct huct huct 


F3 
F4 
F5 
F6 
F7 
F8 
F9 
F10 
NUM 
SCRL 


NP7 
NP8& 
NPY 
NPM 
NP4 
NP5 
NP6 
NPP 
NP 1 
Np2 


Normal 


061 
062 
063 
064 
065 
066 
067 
068 
Num 
Scr 


071 


072 


073 
074 
075 
076 
077 
078 
079 
080 


fky 
fky 
fky 
fky 
fky 
fky 
fky 
fky 
Lk 

Lk 


Table 7-3: Key Values (continued ) 


Shift Control Alt Ctrl-Alt Ctrl-Shft Alt-Shft Description 
086 fky 096 fky 106 fky Layout 2 132 c 133 c¢ F3 

087 fky 097 fky 107 fky Layout 3 132 d 133 d F4 

088 fky 098 fky 108 fky Layout 4 132 e 133 e F5 

089 fky 099 fky 109 fky Layout 5 132 f 133 f F6 

090 fky 100 fky 110 fky Layout 6 132 g 133 g F7 

091 fky 101 fky 111 fky Layout 7 132 h 133 hh F8 

092 fky 102 fky 112 fky Layout 8 132 1 1331 F9 

093 fky 103 fky 113 fky Layout 9 132 j 133 J F10 

Num Lk Hold Num Lk 13] .02 132 ; 133; NUM Lock 

Scr Lk Break Scr Lk Reset Scr Lk Scr Lk Scroll Lock 
071 7 119 fky ALtNP 7 Clicker 132 7 ALtNP 7 Numeric Pad 7 
072 8 134 8 ALtNP 8 Typwrtr 132 8 ALtNP 8 Numeric Pad 8 
073 9 132 fky ALtNP 9 OneFnger 132 9 ALtNP 9 Numeric Pad 9 
074 - 134 074 fky . 132: = 133 Numeric Pad Minus 
075 4 115 fky ALtNP 4 AutoRept 132 4 AlLtNP 4 Numeric Pad 4 
076 5 134 5 ALtNP 5 jrGreen 132 5 ALtNP 5 Numeric Pad 5 
077 6 116 fky  ALtNP 6 - 132 6 ALtNP 6 Numeric Pad 6 
078 + 134 + 078 fky - 132 + 133 + Numeric Pad Plus 
079 1 117 fky  ALtNP 1 132 1 ALtNP 1 Numeric Pad 1 
080 2 134 2 ALtNP 2 132 2 ALtNP 2 Numeric Pad 2 
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Key 


81 
82 
83 
84 
85 
86 
87 
88 
89 
90 


91 
92 
93 
94 
95 
96 
97 
98 
99 
100 


Flags 


et ct ct ct oct ct ct ct ct ct 


Name 


NP3 
NPO 
NPD 
PF1 
PF2 
PF3 
PF4 
PF5 
PF6 
PF7 


PF8 

PF9 

PF10 
PF11 
PFi2 
PF13 
PF14 
PF15 
PF16 
PF17 


Normal 


081 fky 
082* fky 
083 fky 
128 SP 
128! 
128 "Wo 
128 # 
128 $ 
128 % 
128 & 


128! 
128 ¢ 
128 ) 
128 * 
128 + 
128 , 
128 - 
128 
128 
128 


on™ : 


Table 7-3: Key Values (continued ) 


Shift 


081 
082 
083 
128 
128 
128 
128 
128 
128 
128 


128 
128 
128 
128 
128 
128 
128 
128 
128 
128 


Vu A ™s = 


xzuanmvoownwrxr ss 


Control 


118 fky 


134 
134 
128 
128 
128 
128 
128 
128 
128 


128 
128 
128 
128 
128 
128 
128 
128 
128 
128 


0 


<= CH NWO VU: 


~~ 
> KH aN CX KE 


Alt 


ALtNP 3 
ALtNP 0 
ALtNP . 


128 
128 
128 
128 
128 
128 
128 


128 
128 
128 
128 
128 
128 
128 
128 
128 
128 


3 3B - Kee Ss 


x £< Cetonoraiwsd o 


Ctrl-Alt 


Reboot 


129 
129 
129 
129 
129 
129 
129 


129 
129 
129 
129 
129 
129 
129 
129 
129 
129 


SP 


Ctrl- 


132 
132 
132 
129 
129 
129 
129 
129 
129 
129 


129 
129 
129 
129 
129 
129 
129 
129 
129 
129 


Shft Alt-Shft 


Vu AS ee 


xzronmwoqonwrsre~4 


ALtNP 3 
ALtNP 0 
ALtNP . 


129 
129 
129 
129 
129 
129 
129 


129 
129 
129 
129 
129 
129 
129 
129 
129 
129 


< CoA NWO VU 


” 
> KM AN CX KE 


Description 


Numeric Pad 3 
Numeric Pad 0 
Numeric Pad Dot 
PF1 

PF2 

PF3 

PF4 

PF5 

PF6 

PF/ 


PF8 

PF9 

PF10 
PF11 
PF12 
PF13 
PF14 
PF15 
PF16 
PF17/ 
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Table 7-3: Key Values (continued ) 


Key Flags Name Normal Shift Control Alt Ctrl-Alt Ctrl-Shft Alt-Shft Description 

101 ¢t PF18 128 1 128 I 128 a 128 y 129 1 129 I 129 a PF18 

102 t PF19 128 2 128 J 128 b 128 Zz 129 2 129 J 129 b PF19 

103 t PF20 128 3 128 K 128 c 128 € 129 3 129 K 129 c PF20 

104 ¢t PF21 128 4 128 L 128 d 128 | 129 4 129 L 129 d PF21 

105 ¢t PF22 128 5 128 M 128 e 128 } 129 5 129 M 129 e PF22 

106 ¢t PF23 128 6 128 N 128 f 128 ~ 129 6 129 N 129 f PF23 

107 ¢t PF24 128 7 128 0O 128 g 128 RUB 129 7 129 0 129 g PF24 

108 ¢t < 108 < 108 > 134 k 130 k 131 k 132 k 133 k Less Than/Greater Than 
109 ¢t REST 109 SP 134 L 134 | 130 131 lL 132 1 133 Reset 

110 ¢t ENTR 110 CR 134 M 134 m 130 m 131 m 132 m 133. m Enter 

111 ¢t DUP 111 * 134 N 134 n 130 n 131 on 132 n 133 Nn Duplicate Field 
112 ¢t FM 112 ; 134 0 134 oO 130 o 131 o 132 0 133 oO Field Mark 

113 ¢ BTAB 015 fky 113 HT 134 p 130 p 131 p 132 p 133 p Back Tab 

114 ¢ INS O083*fky O82*fky 134 q 130 q 131 q 132 q 133 q Insert 

115 ¢t DEL 083 fky 083 fky 134 r 130 cr 131 fr 132 fr 133 Delete 

116 ¢t DCA1 116 SP 134 § 134 s 130 s 131 s 132 Ss 133 $s DCA1 

117 ¢t UP 072 fky O72 fky 134 ¢t 130 ¢t 131 ¢t 132 ¢t 133 t Up Cursor 

118 ¢t DCA2 118 SP 134 U 134 u 130 u 131 u 132 u 133 u DCA2 

119 t LEFT O75 fky 075 fky 115 fky 130 v 131 v 132 Vv 133 v Left Arrow 
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Key 


120 
121 
122 
123 
124 
125 
126 


Flags 


et ct ct ct ct ct ct 


Name 


HOME 
RGHT 
DCA3 
DOWN 
DCA4 
NPE 

NPT 


Normal 


120 SP 
077 fky 
GS xxLR 
080 fky 
124 SP 
125 = 
126 HT 


Table 7-3: Key Values (continued ) 


Shift 


34. W 
077 fky 
GS xxLR 
080 fky 
134 ¢ 
125 = 
126 HT 


Control 


134 w 
116 fky 
GS xxLR 
134 2z 
134 [ 
134 \\ 
134 ] 


Alt 


130 w 
130 x 
GS XxLR 
130 2z 
130 [ 
130 \\ 
130 J 


Ctrl-Alt 


131 Ww 
1351 x 
GS xxLR 
131 z 
131 
131 \\ 
131] 


Ctrl-Shft 


132 WwW 
132 xX 
GS xxLR 
132 2 
132 [ 
132 \\ 
132 ] 


Alt-Shft 


133 WwW 
133 x 
GS xxLR 
133 z 
133 OE 
133 \\ 
133 J 


Description 


Home/Rule 

Right Cursor 
DCA3 

Down Cursor 

DCA4 

Numeric Pad Equal 
Numeric Pad Tab 
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Appendix A 
Keyboards and Keys 


This appendix provides diagrams that show where 
3270 keys are located on each of the PC keyboards 
| emulated by IRMA 3279 Graphics. Also included 
2 are tables that describe the 3270 keys and give 
their PC key assignments. 


: Keyboards 





IRMA 3279 Graphics lets your PC function like a 

3279 Attribute Select Typewriter/APL Keyboard, 

which provides 12 PF keys, color and highlighting 

attribute select keys, and APL keys. You can 

change this default assignment with GraphPac 

4 (Chapter 2) to have your PC keyboard function as 
either an APL Typewriter Keyboard, or an 

4 Attribute Select Typewriter Keyboard. The 

} requirements of your application program along 

with your host configuration determine which 

keyboard you need. The three 3279 keyboards are 

illustrated on the following pages. 


: Keys 





7 The sections following the keyboard charts locate 

3 and describe keys used to move the cursor, those 
used to alter data, and those used to perform 

~ special host and display functions. 





c-V 








Shift ———— ———— Shift APL 


<——<_—_———— Normal APL 
<——_!—_—\— ALT APL 


Normal —————= 


Control —_—_———gme- 





Figure A-1: Attribute Select Typewriter/APL Keyboard 
(default keyboard) 


Attribute select features are available whether APL is on or off. Note that 
the semicolon (;) on the comma key and the colon (:) on the period key are 
not available unless the APL mode is on. 
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ce 
APL 


k x ie 
nN 

+ Ul | P| 
1 + l= 
it a 
< n< 
oO 

i 

_~ cow} a 


8 


+ @ 
ise 
* ew] 2 
A 
Sale 
Al 
oF 
F wlea 
i Oo 
wn 
ive 
x wl] 2 


eee 
Eigen 


DLL 2 


=e 


im 


a 


Se 
ae 
ai 
F Salar 
fal 
ali? 


Ctrl 


Erase 
ro 


Fa 
Blink 
Venee 


ie 


S z 
= © 
Fa | #2 


<o 
Ave 
Le 
el © 
fea] 
a : 
oO 
wo 
a. 
~” 


Cc 
N 
U 


= 
= 
yee 
yee 


Ea 
ce 
ce 


———_————— Shift APL 


7 2 


Shift ————a 


—<_-—_—_ ~~ Normal APL 


6 


Normal 


<—al-——— ALT APL 


Control —_—_—_——gam_—- | PF6 Q 


Legend 


APL Typewriter Keyboard 


e 
e 


Figure A-3 
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GraphPac Menu Keys 


The keys listed below are used to enter data and 
move the cursor on GraphPac menus. While these 
keys have general PC functions, they function 
differently on GraphPac menus. 


Key Name PC Key Function 
Assignment 


Backspace 





Moves the cursor to the 
previous query field 
and erases data. 











Moves the cursor to the 
Start of the previous 
query field. 


















Moves the cursor to the 
Start of the next query 
field. 


Cursor Down 





Moves the cursor to the 
previous query field 
position. 


Cursor Left 





Moves the cursor to the 
next query field. 


Cursor Right 





Moves to the cursor to 
the beginning of the 
previous query field. 


Cursor Up 





Causes GraphPac to 
process the current menu 
selections. 


Moves up one level in 
the menu hierarchy. 


(continued) 
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GraphPac Menu Keys (cont.) 


Key Name PC Key Function 
Assignment 


HOME <Home> Moves the cursor to the 
beginning of the first 
Iquery field. 












Moves the cursor to the 
start of the next query 
field. 
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Cursor Movement Keys 


These keys move the cursor around the screen. 
Press and hold a key to repeat its function. Note 
that some keys function differently on a screen 
without input fields (unformatted screen). This 
a difference is indicated in parentheses. 


Key Name PC Key Function 
Assignment 


Backtab I< Moves the cursor to the 
beginning of the current 
input field. If the 

cursor is already in 

this position, it moves 

to the beginning of the 
preceding input field. 

On an unformatted screen 
the cursor moves to the 
beginning of line one. 
























Moves the cursor down 
one line. If the cursor 
is at the bottom of the 
screen it moves to the 
Itop of the screen. 


Cursor Down 














Cursor Left Moves the cursor one 
space to the left. If 
ithe cursor is at the 
beginning of a line, it 
moves to the end of the 
previous line. If the 
the cursor is at the 
beginning of the top 
line, it moves to the 
end of the last line. 


(continued) 
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Cursor Movement Keys (cont.) 


Key Name | PC Key Function 
Assignment 


Moves the cursor one 
space to the right. 

If the cursor is at 
the end of a line, it 
moves to the start of 
the next line. If the 
cursor is at the end 
of the screen, it 
moves to the top. 































Cursor Up Moves the cursor up a 
line. If the cursor 
is at the top of the 
screen, it moves to 


the bottom. 





Moves the cursor to 
the beginning of the 
first input field. 
Moves the cursor to 
the beginning of line 
one on an unformatted 
screen. 





Moves the cursor to 
the first unprotected 
space on a following 
line or to the start 

of line one on an un- 
formatted screen. If 


(continued) 
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Cursor Movement Keys (cont.) 


Key Name PC Key Function 
Assignment 


all fields are prot- 
ected, the cursor 
moves to the begin- 
ning of line one. 
Tab I< Moves the cursor to 
7 the beginning of the 
next input field on 
the screen. On an 
unformatted screen, 
moves the cursor to 
the first position 
of line one. 
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3279 Field Editing Keys 


Use the field editing keys to enter new data, 
change existing data, or erase data from input 
fields on the screen. If you press a key while not 
in an input field, the keyboard beeps, then locks 
until you press the RESET key, <F10>. Note that 
some keys function differently on an unformatted 
screen, aS indicated in the descriptions below. 


Key Name PC Key | Function 
Assignment 


DEL <Del> Deletes the charac- 
ter at the cursor 
position and moves 
the other characters 
one space to the 
left. If you press 
the <Del> key when 
the cursor is not in 
an input field, the 
PC’s alarm sounds, 
and the keyboard 
locks until you 
press reset, <F10>. 



























<Alt><g> Puts the DUP charac- 
ter into the current 
input field. Each 
application program 
determines the val- 
idity and function 

of the DUP key. 


(continued) 
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3279 Field Editing Keys (cont.) 





Key Name 






PC Key Function 
Assignment : 


<F6> Erases all charact- 
ers from the cursor 
position to the end 
of the current input 
field even if the 
field continues onto 
another line. On an 
unformatted screen, 
all characters from 
the cursor to the 
jend of the screen 
are erased. 













ERASE 
EOF (End 
Of Field) 

















Erases the contents 
of all input fields 
on the screen and 
places the cursor at 
|the first field. If 
there are no input 
fields, characters 
are not erased, and 
the cursor moves to 
line one. Erases 
all contents of an 
unformatted screen. 





















Puts the field mark 
character into the 
current input field. 
Each application 
idetermines the 
function of the 
{field mark. 


<Alt><h> 










(continued) 
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3279 Field Editing Keys (cont.) 


Key Name | Key Name Function 
Assignment 


NOTE: At times you may not be able to type 
data in a field, even though the field 
appears empty. This can happen if the 
field actually contains a "blank" 
character. If this occurs when you 
need to insert characters, move the 
cursor past the last visible character 
and press the ERASE EOF function 
key, <F6>, to remove the blank 
character(s). 













Changes the mode of 
text entry so that 
new text is inserted 
at the cursor posit- 
ion, while existing 
text moves to the 
right. Press RESET, 
<F10>, to turn off 
this mode and return 
to replace mode. 
(Replace mode types 
Over existing text.) 
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3279 Function Keys 


The host application program you use typically 
determines the function of the 3270 keys listed 
below. Refer to your application program 
documentation for detailed information about each 
function. 


3270 PC Key 
Function |Assignment Description . 


Changes the appearance 
of the cursor. Alter- | 
nate the ALT CURSR key 
with the blink key 
(<Shift><Cursor Left>) 

to get four different 
cursor display modes. 


Requests attention from 
the host. The applica- 
tion program determines 
when this function can 
be used and the re- 
sponse that will be 
received. Refer to the 
mainframe program 
documentation for 
information on using 
this key. 


Sends the clear 
function to the host. 


Enables and disables 

the audible click sound 
produced when you press 
keys at the keyboard. 





(continued) 
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3279 Function Keys (cont.) 









Functions as an IBM 
Selector Light Pen. 


| 3270 | PC Key 
Function |Assignment | 
































Cancels a print request 
that failed due toa 
problem with your 
printer. Does not cancel 
an active print request. 





Provides a controller 
option for use with the 
IBM 3270 Information 
Display Entry Assist 
System. See the "IBM 
"IBM 3270 Information 
Display System Entry 
Assist User’s Guide, IBM 
3174 or 3274 Control 
Unit (GA23-0119). 





Notifies the host appli- 
cation program that you 
have finished entering 
data and are ready to 
continue with the 
program. Your keyboard 
is temporarily disabled 
while the information is 
being processed. The 
host normally responds 
by returning a new 
screen or a message. 


(continued) 
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3279 Function Keys (cont.) 







3270 PC Key 
Function | Assignment Description 


Lets you select the 
printer you want to use 
with your terminal. See 
your host system admin- 
istrator for the printer 
numbers you are author- 
ized to use. 


































Prints the current dis- 
play screen on the host 
printer assigned to your 
terminal. 





Unlocks the keyboard 
when it 1s locked by a 
program error, operator 
error, or system failure 
Before using RESET, 
check the status line to 
determine why the key- 
board locked. Some 
errors, such as printer 
failures, cannot be 
cleared by RESET. Also 
some error conditions, 
such as coax line fail- 
ure, must be corrected 
before the RESET key is 
pressed. 


(continued) 
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3279 Function Keys (cont.) 


PC Key 
Assignment Description 


3270 
Function 


SYS 
REQ 









This key’s use depends 





uration and the host 
application program you 
are using. For specific 
instructions, refer to 
the application 




















Clears your screen and 
places your terminal in 
test mode. When the test 
is complete, a power-on- 
reset is sent to the 

host. You must log on to 
the application program 
to continue operation. 























the test function, see 
the IBM 3279 Problem 
‘Determination Guide. 











upon your system config- 


program’s documentation. 





For more information on 


a3 
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PA Function Keys 


The PA function keys signal the application to 
perform a specific function without processing 
data on the screen. Each application program can 
define different uses for the PA keys and may not 
use all of them. Refer to the documentation for 
the desired application program for specific 
information on the use of the PA keys. IRMA 
3279 Graphics assigns the PA keys to the following 
PC key combinations: 


PAI <Ctrl><j> 
PA2 <Ctrl><k> 


PF Function Keys 


The PF keys are defined by each application 
program to perform specific program functions. 
All the PF keys may not be used by a particular 
application program. Refer to your application 
program documentation for more information. 
The IRMA 3279 Graphics software provides keys 
PF1 through PF12 for the default keyboard layout 
(Attribute Select Typewriter/ APL Keyboard), PF1 
through PF12 for the APL/Typewriter Keyboard, 
and PF1 through PF24 for the Attribute Select 
Typewriter Keyboard. The PF keys are assigned 
to the following PC key sequences. 
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PF Function Keys (cont.) 


Attr. Select 
Typewriter | Typewriter 
Keyboard 


Attr. Select APL 
Typewriter / 


(default) 


<Ctrl><I> 
<Ctrl><2> 
<Ctrl><3> 
<Ctrl><4> 
<Ctrl><5> 
<Ctrl><6> 
<Ctrl><7> 
<Ctrl><8> 
<Ctrl><9> 
<Ctrl><0> 
<Ctrl><-> 
<Ctrl><=> 


<Ctrl><1> 
<Ctrl><2> 
<Ctrl><3> 
<Ctrl><4> 
<Ctrl><5> 
<Ctrl><6> 
<Ctrl><7> 
<Ctrl><8> 
<Ctrl><9> 
<Ctrl><0> 
<Ctrl><-> 
<Ctrl><=> 


<Alt><1> 
<Alt><2> 
<Alt><3> 
<Alt><4> 
<Alt><5> 
<Alt><6> 
<Alt><7> 
<Alt><8> 
<Alt><9> 
<Alt><0> 
<Alt><-> 
<Alt><=> 
<Ctrl><1> 
<Ctrl><2> 
<Ctrl><3> 
<Ctrl><4> 
<Ctrl><5> 
<Ctrl><6> 
<Ctrl><7> 
<Ctrl><8> 
<Ctrl><9> 
<Ctrl><0> 
<Ctrl><-> 
<Ctrl><=> 





- Appendix A - Keyboards and Keys 





Attribute-Select Keys 


The attribute-select keys control the highlighting, 
program symbol set, and color of characters 
displayed at your terminal. Your controller must 
be configured for these attributes in order for you 
to use them. 


To test your controller configuration, perform 
these steps: 


STEP 1: Start the GRAPH emulation program by 
typing, "GRAPH," and pressing, 
<Enter>. 


STEP 2: Once in emulation, activate the TEST 
function by pressing, <Alt><F8>. 


STEP 3: When the word "TEST" displays on the 
Status line, type /8 and press <Enter>. 


= Test patterns appear on the screen. 
Now you can choose the attributes you 
want. 


STEP 4: To reset any attribute display to the 
application program’s original value, 
use the field inherit function. This 
function assigns a different key 
sequence for each of the attribute 
groups. To reset highlighting, press 
<Alt><Ins>. To reset programmed 
Symbol sets, press <Alt><Del>. To reset 
colors press <Alt><+>. 


STEP 5: To exit test mode and return to 
emulation, press <Alt><F8>. 


paaeeer 
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The following sections describe the groups of 


attribute-select keys and the field inherit function. 


Color Select Keys 


The color select function keys let you choose the 
color of the characters you type at the terminal. 
The availability of this function depends upon 
your application program and the controller 
configuration. After you press a color-select key, 
all characters you type will display in the selected 
color. The color assignment appears in columns 49 
and 50 of the status line. The supported colors 
and their PC key assignments are as follows: 


PC Key Assignment 


Blue <Shft><PgDn> 
Green <Shft><Cursor Right> 
Pink <Alt><PgUp> 


Red <Shft><PgUp> 


White <Shft><+> (+ on numeric keypad) 


Turquoise | <Alt><PgDn> 
Yellow <Alt><Cursor Right> 


Field 
Inherit <Alt><+> 





* 
The field inherit key sequence resets colors to the original values set 
by the mainframe application program. 


E aa | 


ES 
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Highlight Select Keys 


Three highlight-select keys let you choose the way 
characters display on the PC screen during a 
network session. Press the key once to activate 
the function. Press the key a second time to turn 
off the function. The active highlight mode 
displays in lines 36-44 of the status line. Note that 
the availability of highlighting depends upon the 
application program in use and the controller 
configuration. 


Description 
Assignment 


<Shift> Causes the char- 
< acters you type 
to blink. 


Reverse <Shif t> Displays charac- 

Video <Home> ters you type in 
reverse video. 

al This means that 

characters and 
the background 
display in 
opposite colors 
from usual. For 
lexample, if the 
characters usual 
ly are green and 
the background 
is black, the 
characters dis- 
play in black 
and the back- 
ground displays 
in green. 





(continued) 
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Highlight Select Keys (cont.) 


PC Key 
Assignment 


<Shift> 
<End> 


Field <Alt> 
Inherit <Ins> 
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Description 


Underlines each 
character that 
you type at the 
keyboard. 


Resets high- 
lighting to the 
values original- 
ly set by the 
mainframe appli- 
cation program. 





(2 eran 
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Program Symbol Set Keys 


The PSA-PSF function keys select the program 
symbol set that IRMA 3279 Graphics uses to 
display all the characters that you type at the 
keyboard. The selected symbol set displays in lines 
31-34 of the status line. Note that your controller, 
as well as the host application must support 
programmed symbols, in order for these keys to be 


valid. 
Symbol PC Key 
Set Assignment 
<Shft><Cursor Up> 


PSA 












PSB <Shft><5> (5 on the numeric keypad) 





PSC <Shft><Cursor Down> 





PSD <Alt><Cursor Up> 





PSE <Alt><5> (5 on the numeric keypad) 





PSF <Alt><Cursor Down> 










Field* 
Inherit 





<Alt><Del> 


* 
The field inherit function resets to the program sybmol sets 
originally specified by the mainframe application program. 
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Appendix B 
Status Line Symbols and Messages 


Introduction 


This appendix describes the messages that may 
display on your screen during emulation. These 
messages display as symbols and text on the "status 
line," a line that appears at the bottom of your 
screen during emulation. Most of the messages are 
provided by the host computer or controller. A 
few messages are provided by IRMA 3279 
Graphics. The status line provides the following 
information: 


color selection 

"do not enter" messages 

highlighting messages 

insert mode selection 

printer status messages 

program symbol set selection 

readiness and system connection messages 
reminder messages 

resident mode selection 

shift and mode messages 


coooo oo o00c0co 


Some of these areas always display a message, 
while others display messages only part of the 
time. These areas are fully described in the 
following sections. 
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Readiness and System Connection 


Messages 





These messages display in columns 1-6 of the status 
line and indicate whether your terminal and the 
host computer are ready to start a session. 


Online 
A 
B 


My Job 
a 


System 
Operator 


Unowned 





A 4 appears in column | of the 
status line when communication 
is established with a 3274 
control unit. This indicator 
must display before you can 
log on to the network. 


An A or B in column 2 of the 
Status line indicates that the 
terminal is "online" (commun- 
icating with the host). If 
column 2 is blank, communicat- 
ion has not been established. 


The display is logically at- 
tached to a mainframe computer 


Your computer is communicating 
with the network control 
program rather than with an 
application program. 


The emulator is running, but 
your computer is not 
communicating with a host 
application program or the 
network control program. 





Ny 
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Do Not Enter Messages 





A "do not enter" message displays when the system 
temporarily cannot accept data. This may happen 
if you type non-numeric characters in a numeric 
field, if you type too many characters in a field, 
if the requested printer is not working, or if the 
host needs more time to complete the previous task. 
The first part of the message displays an X, which 
indicates that the keyboard is temporarily 
disabled. The symbols to the right of the X 
indicate the reason the keyboard 1s disabled. 


Note that some messages display only while the 
host processes your last request and are cleared 
automatically by the system when the request 1s 
complete. However, certain messages, such as X -f 
and X ?4+ require you to press the RESET function 
key, <F10>, to unlock the keyboard and restore 
operation. If you cannot clear a message with 
RESET or the CLEAR function, check the other 
messages on the status line for more information. 


Following is a table listing the "do not enter" 
messages with descriptions and corrective action. 
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Do Not Enter Messages 


Symbol Corrective Action 


The host needs Wait for this message 
more time to to disappear. 
complete your 

task. 


The host locked |o Wait to see if the 
xsystem your keyboard host unlocks the 

after processing keyboard. 

your data. 

o Look up the meaning 
of any system com- 
munication messages 
that may appear. 


o If the host doesn’t 
restore keyboard 
operation, press 
the RESET key, 
<F10>. 


The IRMA 3279 |Press the RESET key, 
Graphics emulat- |<F10>. 

or did not 

accept all or 

part of the last 

Operation. 





(continued) 
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Do Not Enter Messages (cont.) 

















The last operat- 
ion attempted 
was started from 
an incorrect 
location. For 
example, IRMA 
Graphics does 
not allow data 
to be modified 
in a protected 
field. 


You have exceed- 


ed the maximum 
number of 
characters 


allowed ina 


field. 


IRMA Graphics 
does not allow 
non-numeric char- 
acters in a 
numeric field. 


Corrective Action 


o Press the RESET 
key, <F10>. 





















o Then move the 
cursor before 
entering data, or 
perform another 
function. 

















Press the RESET key, 
<F10>, then correct 
the entry. 













Press the RESET key, 
<F10>, then enter 
numeric data or move 
to another field. 








(continued) 
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Do Not Enter Messages (cont.) 


Symbol Corrective Action 


The operation 
you attempted 


requires a number 


different from 
the number you 
entered. IRMA 


Graphics displays 
this message when 


you enter an in- 
valid printer ID 
or printer class. 


The last key you 
pressed is not 
recognized by 


the IRMA Graphics 


emulator. 


The control 
operator sent a 
message that was 
received and 
rejected. 


The last function 
attempted is not 
available or is 
not appropriate 
at this time. 





Press the RESET key, 


<F10>, to unlock the 
keyboard. 


Press the RESET key 
<F10>, to unlock 
your keyboard. 


Press RESET, <F10>, 
to unlock the 
keyboard. 


Press RESET, <F10>, 
to unlock the 
keyboard. 


(continued) 
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Do Not Enter Messages 





Either the key- 
board type you 
selected is not 
Supported through 
your controller 

or the controller 
is not configured 
for this feature. 


Corrective Action 


See Appendix G for 
controller configur- 
ation notes. 

























You attempted to 
perform an un- 
authorized 
printer-related 
function. 


Press RESET, <F10>, 
unlock the keyboard. 



















Press RESET, <F10>, 
and retry your oper- 
ation. If the same 
error recurs, note 
the three-digit 

error code and 
report the problem 
to DCA Customer 
Support. 








Hardware errors 
occurred that 
were internal to 
the 3274, and 
the 3274 could 
not recover. 


























Communications 
error number nn 
or nnn occurred. 


Press RESET, <F10>, 
to unlock the key- 
board. If the error 
persists, refer to 

the "IBM Problem 
Determination Guide" 
to select the 
appropriate action. 


(continued) 
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Do Not Enter Messages (cont.) 
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X PROG nnn 


























The requested 
printer is not 


working. It may 


be out of order, 


unplugged, or out 


of paper. 


The selected 
printer is busy 
and cannot per- 
form the print 
operation you 
requested. 


Program error nn 


Corrective Action 


Press RESET, <F10>, 
to unlock the 
keyboard. 














o Check the printer; 
solve the problem. 






o To restore key- 
board operation, 

press the DEV CNCL 
key, <Shft><F10>. 








o The printer 
message area of 
the status line 
displays the 
status of the job 

being printed 

when the printer 
failed. 











You can wait until 
the printer is not 
busy or press the 
DEV CNCL function 
key, <Shift><F10> to 
unlock the keyboard. 












(continued) 
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Do Not Enter Messages (cont.) 


Symbol Corrective Action | 


The requested You can wait until 
(G:C) printer is busy printer is not busy, 

and cannot per- or you can press the 

form your print DEV CNCL function 

job at this time. key, <Shft><F10>, 

This message to unlock the 

indicates a keyboard. 

longer waiting 

period than the 

"printer busy" 

message. 





Reminder Messages 


Reminder messages display in columns 21 - 27 of 
the status line and indicate the status of the 
communication line between the PC and the host. 
The list below describes the reminder messages 
that may occur. 


Symbol Meaning 


Link Error The link between the host and 
your control unit produced error 
nn Or nnn. This message remains 
set until the control unit detects 
that the error condition has been 
cleared. 


Ignore this message. It is reserved 
for future use. 
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Program Symbol Set Messages 


The program symbol set determines the symbol set 

used by the terminal. The program symbol set you 
select appears in columns 31 - 34 on the status line. 
Status messages include the following: 


Symbol Meaning 

PSA-PSF Program symbol sets PSA, PSB, 
PSC, PSD, PSE, and PSF are 
active. 

SO Base symbol set. 


Status messages that display for the program 
symbol set may be followed by blank characters or 
other symbols. A blank character indicates that 
the program symbol set cannot be changed. If any 
other character or symbol follows the status 
message, you may select other symbol sets. 


Shift and Mode Messages 


Shift and mode messages appear in columns 36-44 
and indicate the current mode of operation. The 
following table describes these messages. 


Symbol Corrective Action 


The keyboard is To cancel this mode, 
in insert mode, and use replace mode, 
SO new text is press RESET, <F10>. 


inserted at the (Replace mode specifies 
cursor position, that new text types 

and exiting text over existing text.) 
moves to the 

right. 





(continued) 
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Shift and Mode Messages (cont.) 


Symbol Corrective Action 


The caps lock key 
has been pressed, 
so all letters 

that you type 
appear in upper- 


Case. 


The APL keyboard 


iS active and 
IRMA Graphics is 
configured for 
the default key- 


board. 


The cursor is in 
a numeric field. 





Press the caps lock key 
again to release this 
mode. 


To switch APL mode OFF 
press the APL On/Off 
function key, <Alt> 
<Backspace>. 


Type only numeric data 
in this field. If you 
type letters or symbols 
the keyboard locks. 
Press RESET, <F10>, 
then type numbers, or 
move to another field. 
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Highlighting Messages 





Highlighting messages display in columns 46 and 
47 of the status line and indicate the mode of 
highlighting that is currently active. Highlighting 
may display in reverse video, as blinking 
characters, or as underscored characters. 


The next character you enter will 
display in blinking mode. 


Reverse The next character you enter will 
Video display in the reverse color. For 


a example, if the character currently 
displays in red and the background 
is black, the next character will 
display in black and its background 
will be red. 


Underscore | The next character you type will be 
a underlined. 
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Color Indicator 





The color indicator displays as a colored block or a 
blue zero in columns 49 and 50 of the status line. 
The colored block indicates the display color of 
the next character you enter. The blue zero 
indicates that the default display color (green or 
white) will be used to display the next character 


you type. 


To change the color indicator and the color of text 
to be entered, refer to ‘Attribute Select Keys’ in 
this appendix. 


Printer Status Messages 


Printer status messages display in columns 60 
through 64 of the status line and indicate printer 
selection, assignment, operation, and failure. 
Following is a description of the messages with 
corrective action where appropriate. 
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Printer Status Messages (cont.) 


Symbol Corrective Action 


You pressed the Type the two-digit 
IDENT function printer ID and press 
key to assign <Enter>. 

a new printer, 

and the emulator 

is waiting for 

you to enter the 

printer number. 


Shows which If no number displays 
C+t1 1" |printers you are in the printer status 

authorized to area, you are not 

use. Printer authorized to use a 

numbers 01-31 are’ |printer. 

individual print- 

ers and numbers 

70-85 are classes 

of printers. 


The printer is 
currently printing 
your job. 


The printer o Press the DEV CNCL 
failed while function key, 
printing your <Shft><F10>, to 

job. It may be unlock the 

out of order, or keyboard. 

it may be out of 

paper. o Fix the printer. 


o Restart the print 
operation. 





(continued) 
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Printer Status Messages (cont.) 


Symbol Corrective Action 


Your printer Press the IDENT 


assignment has function key, 

changed. <Alt><F7>, to display 
your new printer 
assignment. 





Resident Mode Indicator 





An R in column 75 of the status line indicates that 
the IRMA Graphics emulator is running in 
resident mode. The R is an IRMA Graphics 
program message and not a 3279 terminal function. 
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Error Messages 


Introduction 


This appendix lists the error messages that may 
occur while you are using IRMA 3279 Graphics. 
Descriptions of the messages and instructions for 
correcting a message are included. All error 
messages display in the followng format: 


>> > ERROR [000] : TEXT 
| 





| 
Indicates a problem has | 
occurred. | 


| 
| 
| 
| 
| 
Three digit error code | 
number. | 
Explanation of the 
problem. 


Correcting Errors 


To clear an error message, first press the <Esc> 
key to let the emulator know that you are aware 
of the message. Then try to correct the error using 
the instructions in the following tables. If you 
cannot correct a problem, or if any problem 
persists, write the message on paper exactly as it 
appears on your screen, then contact DCA 
Customer Support. In Georgia, call 1-404-442-4470. 
Out of the state of Georgia, call 1-800-631-4171. 





Error Meaning 
Name 


GRAPH IRMA 3279 
Malfunction }|Graphics 
hardware 
failure 


Corrective Action 


Turn off the power to your PC 
for five seconds, then turn 

the power on and run the 
GRAPH program again. 















































An IRMA 3279 
Graphics file 
iS missing. 







Missing 


Make sure that your working 
Graph file 


IRMA 3279 Graphics diskette 
contains all the files shipped 
on the original distribution 
diskette. If a file is 

missing, copy the appropriate 
file(s) to the working disk 
from which you run the IRMA 
3279 Graphics programs. 


















Graph File 
Corrupted 


The GRAPH 
file on your 
diskette 
cannot be 
accessed. 










You possibly have a 
diskette failure or a 


Copy the GRAPH.EXE file from 
the IRMA 3279 Graphics 

PC system malfunction |distribution diskette onto 

or perhaps a file was the disk you use to run 

copied onto the GRAPH|IRMA 3279 Graphics. Then 

file by mistake. try running the GRAPH 
program again. 








(continued) 
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Error 
Code 


007 


008 


t-O 
























Error Meaning Cause Corrective Action 
Name 
O01. 


Graph Board|The IRMA 3279 
Not Plugged |Graphics software 
could not find the 
IRMA Graphics 

hardware. 










Remove the board 
and re-insert it. 
Check all 
connections. Then 
run the GRAPH 
program again. 


Usually this message 
indicates that the graph 
board was not plugged 
in correctly during 
installation, but it can 
also signal a failure on 
the graph board. 













You entered a command 
key that the IRMA 3279 
Graphics emulator did 

not recognize. 


Enter another 
command. 


















File 
Cannot Be 
Opened 






The file you entered 
during the file cap- 

ture Sequence cannot 
be accessed. 


Possible reasons are 
diskette failure, 
unformatted floppy 
diskette, PC disk drive 
failure, diskette full, 
or diskette write- 
protected. 


Try another 
diskette. 






(continued) 
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O11 


O12 





























Diagnostics 
Failure 


Programmed 
Symbols 
Option Not 
Installed. 














This message 
indicates a 
download 
problem. 


Contact DCA Customer Support. 
In Georgia, call 

1-404-442-4470. 

Outside Georgia, call 
1-800-631-4171. 







See error code 002. 












If you have not installed the 
hardware, do so following the 
instructions in Chapter 2. If 
you have installed the hard- 
ware, make sure that it is 
properly installed (see 
Chapter 2). Run the CHK BD 
program in Appendix E to 
check the installation. 










You tried to run 
the IRMA 3279 
Graphics software 
when the IRMA 3279 
Graphics hardware 
was installed im- 
properly or not 
installed at all. 














The file could have 





The file you Capture the screen display 


tried to re- been written over again. 
call does not or corrupted in 
fit in the some other way. 


IRMA Graphics 
format. 


(continued) 
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me, 


Error Error 
Code Name Meaning Cause Corrective Action 


013 Printer You tried to o Check to see that the printer 
File Cannot |do a screen is plugged in properly. 

Be Opened |print, and 
IRMA Graphics 
could not find 
the specified 
printer. 





























o If you have not attached the 
printer, attach it. 









o Check the printer configura- 
tion to see that it agrecs 
with the location of the 
printer. 
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Appendix D 
Glossary 


ASCII 
American Standard Code for Information 
Interchange, the data coding used by most PC 
operating systems and programs. 


Boot 
Load the PC operating system, such as DOS. 
To boot the PC, put the DOS software (or any 
diskette formatted with DOS) into the default 
disk drive and turn on the PC. You must boot 
the PC with DOS before you can run any other 
programs. 


bps (bits per second) 
A method of measuring the transmission rate of 
a channel. BPS measures the number of bits 
that pass a given point in a one-second period. 


Character set 
Symbols that represent the characters that 
constitute a language. 


Configuration 
The values and arrangement of the 
characteristics of the personal computer, 
printer, keyboard, display, and host computer. 


Cursor 
A one-character block or underline that 
indicates your position on the screen. 





Glossary 





Default 
A condition, value, or setting that is used 
automatically unless you specify another 
condition, value, or setting. 


DOS (Disk Operating System) 
A group of programs that the computer uses 
with disks or diskettes that determines how the 
system reads, writes, and organizes information. 


Display 
The PC monitor when used to run a session in 
emulation. 


Drive designator 
A single alphabetic character that names a 
diskette drive, a hard disk drive, or a logical 
drive. It is followed by a colon; for example, 
re 


EBCDIC 
Expanded Binary Coded Decimal Interchange 
Code, the data code used to represent 256 
unique letters, numbers, and other characters 
used by IBM host computers. 


Emulator 
A computer system or component that functions 
like another computer system or component. 
GRAPH.EXE 1s the IRMA 3279 Graphics 
emulator which lets your PC function as a 3279 
graphics terminal. 


Extension 
A filename suffix made up of a period 
followed by one to three characters. Blank 
spaces are not allowed in filename extensions. 





Glossary 





Field 
A defined position in a program that contains 
information entered by the user or generated 
by the program. Fields can be protected (they 
only display information) or unprotected (you 
can enter information in them). 


File 
A collection of data that the personal computer 
treats as a single unit. Each file has a unique 
filename to identify it. 


File specification 
Indicates the name and location of file. It can 
include a drive designator, a directory path, a 
filename, and an extension. 


Host Computer 
The primary or controlling computer whose 
Operating system and applications you can use 
when you enter emulation. 


Hot Key 
The <Shft><Shft> key combination on the PC 
keyboard. In emulation, the Hot Key switches 
between a host session and DOS. 


Keyboard Profile 
A file containing key definitions created with 
the KYBDEDIT program described in Chapter 
7. A keyboard profile has a .K YB extension. 


Macro File 
A file containing key definitions created with 
the <Alt><+> procedure described in Chapter 6. 
A key macro file has a .KMC extension. 


Network 
A communication system that sends and 
receives data over a cable. It can contain a 
host operating system, terminals, printers, and 
other devices in one or more locations. 
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Programmed Symbol Sets 
User definable character sets which may 
represent characters or graphics and may be 
altered by host application software. 


Session 
A logical connection with the host computer. 
The session begins when you log on to the host, 
and ends when you log off. 


Status Line 
The line on your display screen that reports the 
status of the communications system, the system 
connection, keyboard, printer, numeric mode, 
cursor, communications link, and error 
conditions. 


Terminal 
A hardware device, such as a monitor-keyboard 
combination, that gives a user access to a host 
computer. IRMA 3279 Graphics lets your PC 
function as a 3279 S3G graphics terminal. 





Appendix E 
Diagnostics 


Introduction 


The CHKBD program described in this appendix 
lets you check the accuracy of your hardware 
installation. The first part of this program tests 
the emulator board, while the second part of the 
program checks the graphics board and display 
characteristics. If you are using the upgrade, the 
first part of the program tests the IRMA emulator 
board. 


CHKBD Command Options 





Before you start the CHK BD program, look at the 
help menu to get an idea of the kinds of tests 
CHKBD runs and the options you can use with the 
CHKBD. To view the help menu, boot your PC 
with DOS, following your usual procedure. With 
the working copy of IRMA Graphics in the default 
drive and directory, type the command: 


CHKBD -? <Enter> 


The following screen displays, listing the options 
you can use in the CHK BD command line: 
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DIGITAL COMMUNICATIONS ASSOCIATES 
IRMA 3279 GRAPHICS UPGRADE INSTALLATION TEST 
VERSION 2.06 02/28/86 
INSTALLATION TEST OPTIONS 


- AXXX --- address -- define xxx as base address 
-V --- verbose -- expanded error reporting 

-c --- continue -- continue test on error 

v6 --- repeat -- loop on selected tests 

- tXX --- test -- xx selects Coax Board tests 
- 9XX --- graph -- xx selects Graph Board tests 


-t for all tests, or select tests by bits set in -txx: 

01 - 10 - Display Ram 

02 - Download Ram 20 - Coax Loopback 

04 - Download 8x305 File 40 - Controller Detect 
08 - Read/Write Registers 


BPs all tests, or select tests by bits set in -gxx: 


Download Graph File 10 - Cursor Test 
02 - CRTC Test 
04 - PS Ram Test 
08 - Color Video Test 
B> 


These options let you customize the installation 
diagnostic program to fit your particular needs. 
Any option can be entered in the format: 


CHKBD -X <Enter> 


".-X" is one of the options listed on the help menu. 
These options are described in detail in the 
following table. 
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CHKBD Command Options 


Description 


The test and -? options 
display the available test 
options described in this 
table. Command format: 
CHKBD -? <Enter> 


Specifies the address of the 
board you want to test. 
Insert the address in place 
of xxx. Command format: 
CHKBD -axxx 


Prints all known data for 
the option in the event of a 
failure. Command format: 
CHKBD -v 


Continues to run the 
installation test even after 
the program detects an error. 
Command format: 

CHKBD -c 


Repeats the entire test 
continuously until you 
terminate it by pressing any 
key (which returns control 
to DOS). Use this option to 
help track down an 
intermittent hardware 
problem. Command format: 
CHKBD -r 
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CHKBD Command Options (continued ) 


Command 
Options Description 


-2XX Specifies the number of the 
graphics board test you want 
to run. The tests are as 
follows: 


01 - Download Graph file 
02 - CRTC Test 

04 - PS Ram Test 

08 - Color Video Test 

10 - Cursor test 


Insert the test number in 
place of xx, e.g. -g04. 


Command format: 
CHKBD -g01 


-txx Specifies the number of a 
particular emulator board 
test that you want to run. 
The tests are as follows: 


02 - Download Ram 
04 - Download 8x305 file 
08 - Read/Write registers 
10 - Display Ram 
20 - Coax Loopback 

40 - Controller Detect 


Insert the test number in 
place of xx, e.g. -t04. 


Command format: 
CHKBD -t04 
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Starting CHKBD 


kkKKK 


To start the CHK BD program, execute the CHK BD 
command at the DOS prompt, including any 
options. A screen displays with the title of the test 
and the options to be tested. The program then 
begins to test the emulator board. 


DIGITAL COMMUNICATIONS ASSOCIATES 
GRAPH INSTALLATION TEST 
VERSION 2.07a 05/22/86 


Find Board Address << Add = 280 >> 
Download RAM 160 << **Testing** >> 
Download 8x305 file 

Read/Write Registers 

Display Ram 

Coax Loopback 

Controller Detect 


As each item is tested, the <<***Testing***¥>> 
prompt displays to the right. If no error is 
detected with that item, the prompt, 

<<---OK--->> replaces the testing prompt. If an 
error 1s detected, an error number appears beside 
the item that failed, testing terminates, and an 
error message displays at the bottom of the screen. 
You must refer to the error message Section in this 
chapter to correct the error, then restart the 
program. (Note that you can include the [-c] 
option with the CHK BD command to continue 
testing after an error is found.) 
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Emulator (Coax) Board Tests 


The first part of the CHK BD program runs the 
following tests on the emulator board. 


Download RAM Test 


Tests the data path from the 8088 to the download 
RAM bank, download RAMs, and increment 
address circuitry. 


Download of 8X305 File 


Tests the data path to the RAMS. RAM integrity 
as a 16-bit checksum value is checked by the 8088 
for the downloaded data. It tests the data path 
between the RAMS and the 8X305. 


Read/Write Register Test 


Tests the communications path from the PC to the 
8X305 and back. It also checks the IV Bus lines 
for independence and the IV Bus decoding. 


Display RAM Test 


Tests the data path from the IV Bus to the display 
RAMS. It also tests the display RAMs and parity 
error checking hardware (error reset hardware). 


Coax Loopback Test 


Tests the data path to the transmitter and receiver, 
and the transmitter status bits. It also checks the 
receiver status bits, the transmit-receive data path, 
all possible data transmitted and received in 
loopback mode for contiguous and noncontiguous 
transmission, parity detection circuitry, and error 
checking circuitry by forcing errors. 
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Controller Detect Test 


Checks to determine whether an active coax line is 
connected from the controller to the emulator 
board and issues a message if one 1s not connected. 


Graphics Board Tests 


If the emulator board test completes without an 
error, CHK BD automatically starts testing the 
graphics board. The test title and a list of items to 
be tested display on the screen similar to the 


following: 
DIGITAL COMMUNICATIONS ASSOCIATES Model GRAPH Rev 1 
GRAPH INSTALLATION TEST SN 00103, CIC 01 
VERSION 2.07A 05/22/86 MFG DATE: 04/18/86 


Find Board Address << Add = 280 >> 
Download Ram /7f0 <<----- OK---->> 
Download 8x305 File 

Read/Write Registers 

Display Ram 003 

Coax Loopback 

Controller Detect 


Graph Board Test 


Download Graph File 
CRC Test 

PS Ram Test 

Color Video Test 
Cursor Test 


Installation Diagnostics Pass. 


Please connect an active coax cable to the board and 
proceed with normal use. 


The graphics board test displays several screens 
that let you evaluate graphic attributes and cursor 
types. The tests that check the graphics hardware 
are as follows: 
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Download of Graph File 


The 8X305 file containing the executable PS tests 
is loaded into RAM and started. The load module 
used is not the same as the module used for the 
emulator board tests. 


CRTC Test 


Tests the CRTC by loading different CRT timing 
parameters and monitoring the video 
enable/disable bit. 


PS RAM Test 


Tests the programmed symbols’ RAM. Checks the 
IV Bus pathways on the graphics board, as well as 
the right bank decoding, mask registers, and PS 
RAM. 


Color Video Test 


Loads the character fonts into PS RAM from the 
file "GRAPH.FNT" and displays several screens for 
user inspection. Screens contain display attributes 
and character fonts, as well as attribute wrap and 
field attribute propagation (see the next section of 
this guide, entitled, ‘Color Video Test’). 


Cursor Test 


Tests the cursor display, cursor modes, and cursor 
addressing with respect to the screen (see the next 
section, ‘Color Video Test’). 


NOTE: If you are using the graphics upgrade 
board with IRMA, and the top 
connector for the boards 1s not properly 
installed, you may get the following 
message: 
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IRMA 3279 Graphics option not installed 





If this occurs, refer to the installation instructions 


in Chapter 1 and check the installation of the 
boards. 


Color Video Test 


The color video test presents the four-color field 


attribute display and the seven-color extended 
field attribute display test screens. When IRMA 
3279 Graphics is properly installed, test screens 


display the attributes listed below. Press any key 
to hold a screen for viewing. To resume testing, 
press <Enter>. Screens are described from top to 


bottom and from left to right. 


The four-color field attribute screen displays the 


following: 

o The ROS and APL character sets in green 
o The status line symbols in green 

o All labels in red 


o The words "green," "blue," "red," and "white" 
their respective colors 


o A line and status symbols in blue below the 
thirty-second line 


The seven-color extended field attributes screen 
displays the following: 


o Rectangles in each of the extended colors: bl 


in 


ue, 


red, pink, green, turquoise, yellow, and white 


o A list of the extended attributes in yellow 
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o Beside the attribute list, a field containing each 
of the extended colors, demonstrating the 
attribute (i.e. beside "blinking," the name of 
each color flashing on and off) 


o Attribute wrap, demonstrating how each 
attribute extends from the end of one line to 
the line below it. All extended colors are used 
in the display, showing wrap characteristics 
twice. For example, "Reverse" 1s displayed once 
in white and once in pink. 


Cursor Test 


The cursor test checks the four types of cursors 
available when IRMA 3279 Graphics is properly 
installed. Each type of cursor is used to draw the 
following: 


o Non-blinking underline, red chevron pattern 
o Blinking underline, blue chevron pattern 
o Non-blinking block, turquoise chevron pattern 


o Blinking block, pink chevron pattern, which 
continues to blink until the test is complete 


NOTE: If the test is interrupted, press <Enter> 
to resume testing. 


Installation Error Messages 


When an error occurs during the CHK BD test, 
testing terminates (unless you used the [-c] option 
with the CHK BD command), and an error message 
appears at the bottom of the screen. The error 
message contains an error number, which identifies 
a specific failure point, and an error type, which 
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identifies the general nature of the problem. Error 
numbers also display beside the item that failed 
the test. 


Follow the information in the message to resolve 
your problem. If you cannot correct the error, 
write the error number and message on paper, 
remain at your PC if possible, and contact DCA 
Customer Support. In Georgia, call 1-404-442-4470. 
Out of the state of Georgia, call 1-800-631-4171. 
Error types reported by the installation test and 
suggested corrective measures are described below. 


Error Type 201 TEST FILE IS MISSING 
Error Type 202 TEST FILE IS CORRUPTED 


These error messages suggest that the files needed 
for testing are not present on the disk you are 
using to run the installation test, or that these files 
have been damaged. First, check your disk for the 
following files: 


CHKBD.EXE 
CHKBD.8X3 
INSGRAPH.8X3 
GRAPH.FNT 


If any of these files is not on your working IRMA 
Graphics diskette, copy the missing file(s) from the 
IRMA 3279 Graphics distribution diskette. 


If all the files are present on your working 
diskette, recopy these files from the original IRMA 
Graphics diskette. Refer to your DOS manual for 
instructions on copying, if necessary. 


Error Type 203 POSSIBLY A USER INDUCED 
PROBLEM 


This error occurs when the base address of the 
IRMA Graphics board is the same as the base 
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address for another board in the PC, or when the 
IRMA Graphics boards are not properly seated in 
the expansion slot. Check the JP1 and JP2 jumpers 
that determine the base address, then remove the 
IRMA Graphics hardware and re-insert it, making 
sure that the boards are properly seated and the 
top connector is secure if you are attaching your 
IRMA board to the graphics upgrade board. If the 
Same error occurs again, try a different expansion 
Slot. 


Error Type 204 PROBABLY A MORTAL 
FAILURE 


This error message usually indicates a problem 
with the emulator board. Make sure that the cable 
that connects the emulator board and the graphics 
board is securely connected to both boards. If the 
same error occurs again, run the CHK BD program 
and use the -txx option to check the emulator 
board (see ‘CHK BD Command Options’). 


Error Type 205 PROBABLY A MORTAL 
FAILURE 


Indicates that either a software error or a PC 
hardware failure that IRMA Graphics cannot 
identify has occurred. Contact DCA Customer 
Support. 


Error Type 206 PROBABLY A MORTAL 
FAILURE GRAPH BOARD 


This error message usually indicates a faulty 
IRMA Graphics board, although it can also 
indicate a software problem. If the problem 
persists, report the failure to DCA Customer 
Support. 
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Advanced Utilities 


Introduction 


This appendix explains how to use the advanced 
features of the GraphPac program to remap 3270 
key assignments on the PC keyboard. (If you have 
previously used KYBDEDIT to remap your 
keyboard, you should continue to do so.) Because 
KYBDEDIT and this GraphPac option can 
radically alter your keyboard, possibly making 
some keys unrecognizable, both functions should 
be implemented only by programmers or 
experienced users. Most keyboard changes can be 
made satisfactorily with the <Alt><+> procedure 
described in Chapter 6. 


The key remapping utility is the second option on 
the keyboard configuration menu. Four general 
steps are required to change a key: 

1) Start GraphPac. 

2) Select the keyboard remapping option. 

3) Choose the 3279 function key. 


4) Specify whether to add (assign) or delete the 
3279 function. 


5) Select the PC key where you will add or 
delete the 3279 function. 


These steps are described in detail in the following 
section. 
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Remapping 3279 Key Assignments 





The following steps explain how to add or delete a 
3279 function from the PC keyboard. 


STEP 1: Start GraphPac by typing the following 
command at the DOS prompt: 


GP <Enter> 
STEP: 2: Select the keyboard remapping option. 


A) From the GraphPac main menu, 
select "Configure Keyboard" by 
typing 2 and pressing <Enter>. 
The following menu displays: 


CONF 1G-KEYBOARD 


-GraphPac- 
_IRMA 3279 Graphics ; 
(c) 1986 Digital Communications Associates, Inc. 


1 - Configure Keyboard Type 


2 - Configure Keyboard Mapping 


_ > Select One 


ESC - Previous Menu ENTER - Process Selection TAB - Next Field 


B) From this menu, select "Configure 
Keyboard Mapping" by typing 2 
and pressing <Enter>. A 3279 
keyboard outline displays. 


The 3279 keyboard on your screen places a number 
over each 3279 key location. These numbers are 
used to reference the underlying 3279 key. The 
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following page shows an actual Attribute Select 
Typewriter/APL keyboard with these numbers 
printed in purple above each key. 


NOTE: If you are using one of the other 
keyboards emulated by IRMA Graphics, 
see the IBM 3270 Information Display 
System Character Set Reference, GA27- 
2837-6 for the keyboard layout. Then 
reference those keys with the numbered 
layout on the screen or on the next 
page. 
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mens 


STEP 2: Choose the 3279 function key. 


A) From the previous page, select the 
3279 key that you want to 
configure. The purple number is 
the reference number. 


B) If the 3279 key is in a normal 
(unshifted) position, type the 
reference number and press 
<Enter>. 


C) If the key is in another position, 
type "s" before the key number for 
a shifted key (i.e. $52). Type "a" 
before the key number for an 
alternate (Alt) position (i.e. a30). 


After you enter the 3279 key reference number, 
the following prompt displays: 


The 3279 key selected is ENTER (76) and it is configurable. 


Is this the correct key ([y]/n)? 


If you pressed a key by accident, type "n" and 
press <Enter> to avoid changing the key. The 
previous prompt returns, and you can select 
another 3279 key to configure. 


If the key name displayed is the correct one, 
Simply press <Enter>. A numbered PC keyboard 
outline displays with a prompt. 


STEP 3: Specify whether to add or delete the 
3279 function. 
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The prompt that displays with the numbered PC 
keyboard reads similar to the following: 


Space (57), Shift Space (Shift 57), 
There are 2 existing configurations for the key selected. 


Select the update desired. 
Enter '[a]' for ADD, 'd' for DELETE, 'n' ffor NO CHANGE. 


The first line gives the PC keys that function as 
the 3279 key you entered in STEP 2. The second 
line confirms that the configuration exists. The 
third line prompts you for action. The fourth line 
lists what you can do with the 3279 function. You 
can do the following: 


A) Press <Enter> if you want to add the 3279 
function to an additional PC key. 


B) Press <d>, then press <Enter> to delete the 
3279 function from a PC key. 


C) Press <n>, then press <Enter> to make no 
changes to the existing key assignments. 


After you perform one of the options above, the 
Screen prompt reads: 


Select the PC key to be configured. 


Prefix the key nuee with "A" for ALT, "C" for CTRL, 
and "S" for SHIFT 


STEP 4: Select the PC key where you will add 
or delete the 3279 function. 


The following page shows the PC keyboard with 
the reference numbers in purple print. 
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A) From the previous page, select the PC key that 
will function as the 3279 key. The purple 
number above the key is the reference 
number. 


B) If the PC key is in the unshifted position, 
type the reference number and press <Enter>. 


C) If the PC key is in another position, precede 
the number with a for Alt, c for Ctrl, or s for 
shift. 


D) If you are deleting a 3279 function from the 
PC key, GraphPac will prompt you to confirm 
that you want to delete the function. 


E) If the PC key you select is already being used 
for a 3279 function, GraphPac tells you so and 
gives you the option to reassign the key or to 
leave it as it is. If you do not reassign this 
key, GraphPac lets you select another PC key. 


After you complete step 4, GraphPac displays the 
following prompt: 


Do you wish to configure another key? ([y]/n)? 


Press <Enter> to configure another key. Press <n> 
and <Enter> to exit the keyboard remapping 
option. 


Appendix G 
Controller and Mainframe Configuration 


Introduction 


This appendix is provided only as a reference for 
the System Programmer to use when configuring 
the mainframe computer and the controller for use 
with IRMA 3279 Graphics. This appendix should 
be ignored by the IRMA 3279 Graphics user. 


SCP I/O Generation Parameters 





The configuration that the system programmer uses 
at the mainframe depends upon the operating 
system used. The following table gives the 
configuration for controllers operating under 
VM/CMS and MVS/TSO. 
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Table G-1: SCP I/O Generation Parameters 


Protocol Operating System 
Environment VM MVS 


LOCAL 3274 DEVTY PE=3279 UNIT=3279 
NON-SNA MODEL=3 MODEL=3 


LOCAL 3274 DEV TY PE=3705 UNIT=3791L 
SNA MODEL=E8 
ADAPTER=TYPE4 


REMOTE 3274] DEVTYPE=2703 UNIT=3279 
NON-SNA CLUSTER=3274 MODEL=3 
TERM=3279 
MODEL=3 


REMOTE 3274| DEVTYPE=3705 UNIT=3791L 
SNA MODEL=E8 
ADAPTER=TYPE4 





VTAM Generation Parameters 
The VTAM generation parameters are shown in 


Tables G-2 and Table G-3. 


Table G-2: VTAM Generation Parameters 


NON-SNA Terminal MODETAB=M32783 
DLOGMOD=M32783B 

SNA Terminal MODETAB=M32783 
DLOGMOD=M32783S 










£-D 


LOCAL NON-SN 


SIABC123 LOCA 


LOCAL SNA 


SIXYZ122 


REMOTE SNA 


SIXYZ348 LU 


CUADDR=123, 
TERM=3277, 
DLOGMOD=M32783B, 
FEATUR2=MODEL2, 
ISTATUS=ACTIVE, 
MODETAB=M32783, 
USSTAB=USSEAB 


LOCADDR=02, 
DLOGMOD=M32783S, 
MODETAB=M32783, 
USSTAB=USSSNA 


LOCADDR=08, 
ISTATUS=ACTIVE, 
DLOGMOD=M32783S, 
MODETAB=M32783, 
PACING=0, 
VPACING=0 


Table G-3: VTAM Generation Parameters 


CU address 

3270 type display terminal 
IBM non-SNA mode table 
Model 2 display - 24 x 80 
Initial status active 

IBM mode table 

Graphics USS table 


Controller port address 
IBM SNA mode table 
IBM mode table 

SNA Graphics USS table 


Controller port address 
Initial status active 
IBM SNA mode table 
IBM mode table 
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Mode Tables Using IBM Default Parameters 


Following are mode tables that use the IBM 
default parameters. 


Table G-4: Mode Tables (IBM Default Parameters) 


NON-SNA 


M32783B MODEENT 


SNA 


M32783S MODEENT 


Notes: 


LOGMODE=M32783B, 

FMPROF=X’02’, 

TSPROF=X’02’, 

PRIPROT=X’°71’, 

SECPROT=X’40’, 

COMPROT=X’2000’, 

PSER VIC=X’008000000000185020507F00’ 


LOGMODE=M32783S, 
FMPROF=X’03’, 
TSPROF=X’03’, 
PRIPROT=X’BI’, 
SECPROT=X’90’, (see Note 1) 


COMPROT=X’3080’, 

RUSIZE=X’88C7’, 

PSER VIC=X’028000000000185020507F00’ 
(see Note 2) 


1. SECPROT = X’90’ for MVS and VM environments 
= X’A0’ for VCNA environments 


2. PSERVIC = X’..80...’ for MVS and VM environments 
= X’..CO.... for VCNA environments (This 
value works properly even though it 
conflicts with VCNA documentation on 
valid queriable device values.) 
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The PSERVIC parameter controls a variety of 
terminal characteristics. For further information, 
consult the following manuals: 


IBM GDDM Installation and System Management 
Guide, SC33-0152 (Appendix E) 


VTAM Version 3 Releases 1 and 1.1 Programming, 
SC23-0115 


Appendix H 


AT&T Installation Guide 


Introduction 


This appendix shows how to install the IRMA 3279 
Graphics hardware and the upgrade hardware in 
your AT&T 6300 computer. These instructions 
differ slightly from those provided in Chapter 2 
for installing the hardware in an IBM personal 
computer. 


NOTE: Be sure to select the AT&T 6300 
monitor from the CONFIG-VIDEO- 
MONITOR when running GraphPac. 
See Chapter 2 for instructions on using 
GraphPac. 


Installing the Hardware 


Included with your package are two short video 
cables. Take these cables out of your package 
along with the IRMA 3279 Graphics hardware and 
follow the steps below. (If you are installing the 
graphics upgrade to IRMA, follow steps 1 through 
7, then complete the instructions in the next 
section.) 


STEP 1: Set the jumpers on the board following 
the instructions provided on pages 1-5 
through 1-7 of the user’s guide. 


STEP 2: Turn the PC power off and disconnect 
the power cord from the wall’s 
electrical outlet. 
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STEP 3: Turn off all externally attached devices 
such as printers, modems, etc. Remove 
any remaining power cords from the 
electrical outlet on the wall. 


STEP 4: Remove all cables from the back of the 
system unit, noting the location of each 
cable. 


STEP 5: Set the display monitor next to the 
System unit. 


STEP 6: Remove the top two cover screws from 
the outside rear panel, as shown in the 
following diagram. 
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STEP 7: Carefully slide the cover forward about 
half an inch, then lift it up and remove 
it as shown in the following diagram. 
Set the cover aside. 





If you are using the upgrade, skip to the next section 
entitled, “Installing the Upgrade.” 


STEP 8: Choose the expansion slot where you 
_ will install the IRMA 3279 Graphics 
| board. To promote cooling, leave at 
= least one slot between IRMA 3279 
Graphics and the AT&T display 
adapter. 
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STEP 9: If you haven’t already done so, remove 
the expansion slot covers and screws. 
Save the screws for later use. 





STEP 10: Insert the IRMA 3279 Graphics board 
into the expansion slot with the sockets 
of the board projecting out of the back 
of the system unit. 
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STEP 11: Push the opposite end of the board into 
the white plastic guides at the base of 
the expansion slot. Press down on the 
board until it is well-seated in the slot. 
Secure the board with the screw you 
removed in STEP 9. 





7 STEP 12: Replace the computer cover by 
3 reversing the procedures outlined in 
STEPs 6 and 7. 


| STEP 13: Connect the coax cable (not provided) 

; from your communications controller to 
the round socket (BNC connector) at 
the bottom of the IRMA 3279 Graphics 
board. Rotate the connector on the 
cable until it locks into place on the 

2 board. 


Appendix H - AT&T Installation Guide 





STEP 14: To connect the IRMA 3279 Graphics 
board (or upgrade) and the AT&T 
display adapter, use one of the short 
cables supplied with your package. 
Insert the 25-pin end of the cable into 
the 25-pin socket on the AT&T display 
adapter. Insert the 9-pin end of this 
cable into the bottom 9-pin socket on 
the IRMA 3279 Graphics board. See 
the diagram below. 


STEP 15: Use the other short cable to connect the 
IRMA 3279 Graphics board with the 
AT&T monitor. Insert the 9-pin end 
into the top 9-pin socket on the IRMA 
3279 Graphics board. Connect the 25- 
pin end with the 25-pin connector on 
the cable from the AT&T monitor. See 
the following diagram. 


MONITOR 


oN 










Caf 











COLOR 


| rl - | GRAPHICS/ 
7 ADAPTER 


NI 


[PF =N 
25-PIN FORTEGRAPH 


LN BOARD 





PineN 


STEP 16: 


STEP 17: 
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Reconnect all cables, including the 
power cord, plug the necessary cords 
into electrical outlets, and boot your 
computer with DOS. 


Run the installation diagnostic test 


described in Appendix E of the user’ 


guide. 


Installing the Upgrade 





S 


After finishing steps 1 through 7 in the previous 


section, perform the following steps to complete 


the IRMA Graphics upgrade installation. While 
you can install the graphics upgrade board and the 
IRMA board in any of the slots in the AT&T 
computer, we recommend that you install the 
graphics upgrade board next to the display adapter 
and position IRMA in the adjacent slot. 


STEP 8: 


STEP 9: 


STEP 10: 


STEP 11: 


Choose the expansion slot where you 


will install the upgrade hardware. Fit 


the pins of the board into the white 
plastic guides at the base of the 
expansion slot and press firmly. 


Replace the IRMA board beside the 
graphics upgrade board. 


Replace the retaining screws that secure 


the boards to the PC frame. 


Connect the graphics board to IRMA, 
positioning the 60-pin connector over 


the edge connector at the top of the 
IRMA board. Push down on the 


connector so that it is mounted securely 


on the IRMA board. 
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STEP 12: Replace the system unit cover by 
reversing the instructions in STEPs 6 
and 7 of the previous section. 


STEP 13: Connect the coax cable to your IRMA 
board. 


STEP 14: Complete the installation by following 
steps 14 through 17 in the previous 
section. 
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Customer Support Information 


Introduction 


Digital Communications Associates, Inc. makes 
every effort to ensure that the product you have 
purchased is of excellent quality in all respects. 
All hardware and software products have been 
tested and subjected to strict quality control 
procedures. User’s guides are designed and written 
to provide you with complete and accurate 
instructions on how to use your DCA product. 

You are encouraged to comment on the IRMA 3279 
Graphics User’s Guide by filling out and sending 
in the customer response form included in this 
section. 


DCA Customer Support personnel are available to 
assist you from 8:30 a.m. to 8:00 p.m. Eastern 
Standard Time (EST). Outside Georgia dial 1-800- 
631-4171. In Georgia, or outside the US., dial 1- 
404-442-4470. If you need to call Customer 
Support, be sure to remain at your PC, if possible, 
so that you can follow any directions you receive. 
Also, have error numbers and messages written on 
paper exactly as they display on your screen, so 
that Customer Support can promptly assist you. 


The Customer Support section includes the 
following information: 

Limited Product Warranty: 

The warranty provides a one year limited 


warranty on the IRMA 3279 Graphics hardware 
and the upgrade hardware. 
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Diskette Replacement Policy: 


DCA’s diskette replacement policy and procedure 
for return are described in this section. For 
additional information regarding your rights in 
using DCA software, see the LICENSE 
AGREEMENT enclosed with your diskettes. 


Return for Repair Procedure: 


This section provides instructions on returning 
hardware units to DCA for repair or replacement. 


Statement of Copyright Restrictions: 


This section outlines your rights and 
responsibilities when using DCA software and 
documentation. For additional information 
regarding your rights in using DCA software and 
documentation, see the LICENSE AGREEMENT 
enclosed with your diskettes. 


Product Registration Card: 


This card, attached to the back cover of this guide, 
allows you to register your product with DCA. 

Fill it out and send it in. This validates your 
warranty and provides DCA with a way to keep 
you informed of any product updates that may be 
made. Postage is prepaid. 


Customer Response Form: 


This card is provided so that you can comment on 
the IRMA 3279 Graphics User’s Guide. 


' eae eee | 
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Complete the following information about your 
IRMA 3279 Graphics product and save this form 
for your records. 


IRMA 3279 Graphics 


Hardware Serial Number 
Software Version Number 
Date of Purchase 


Place of Purchase 





Limited Product Warranty 


Digital Communications Associates, Inc. ("DCA") 
warrants the IRMA 3279 Graphics product 
hardware to be free from defects in material and 
workmanship under normal, proper and intended 
use in its unmodified condition for one year from 
the date of purchase by the first End User 
("Purchaser"). This warranty does not cover 
normal wear and tear, or damage caused by 
accident, negligence, vandalism, alteration, abuse, 
misuse, improper installation, environmental stress, 
or acts of God. 


DCA warrants that the product firmware will 
conform to DCA’s product specifications 
prevailing at the time of purchase. This firmware 
warranty makes no claim of compatibility with 
equipment or software supplied or to be supplied 
in the future by others. 
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DCA’s sole obligation under this hardware and 
firmware warranty shall be to furnish parts and 
labor for the repair or replacement of the product 
found by DCA to be defective in material or 
workmanship during the warranty period. This 
limited warranty is non-transferable and applies to 
the original End User Purchaser of the product 
and does not apply to subsequent purchasers 
through resale by the first End User. 


Warranty repairs will be performed at the DCA 
manufacturing facility or DCA designated repair 
facility. Purchaser should first contact a Service 
Representative at DCA to arrange for warranty 
service. Equipment for warranty service should 
then be returned postpaid to DCA and be 
accompanied by proof of purchase and a written 
description of the defect. Upon repair or 
replacement the equipment will be redelivered by 
DCA freight prepaid to the Purchaser. 


This express limited warranty is in lieu of all other 
warranties express or implied, statutory or otherwise, 
including all implied warranties of merchantability 
and fitness for a particular purpose or use. DCA 
Shall not be liable for any damages sustained by 
purchaser or any other party arising from or relating 
to the use or performance of the product, or to any 
equipment failure, including, but not limited to 
consequential damages, nor shall DCA have any 
liability for delays in replacement or repair of 
related equipment or the DCA product. 


Each End User who returns the Product 
Registration card to DCA shall be notified of 
product upgrades as they become available during 
the limited warranty period. 
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Diskette Replacement Policy 





Digital Communications Associates, Inc. ("DCA") 
warrants to the original consumer purchaser (the 
"Purchaser") only, that the magnetic diskette on 
which the computer program accompanying this 
DCA Product (the "Product") and limited warranty 
is recorded will be free from defects in materials 
and/or workmanship under normal use and service 
for a period of ninety (90) days from the date the 
Product is purchased by Purchaser. If, during this 
ninety (90) day period a defect in the diskette 
Should occur, the diskette may be returned to DCA 
for replacement. The DCA Product this diskette 
accompanies must be registered with DCA. 
Purchaser should call DCA Customer Support for a 
return authorization number and then return the 
diskette, postage prepaid, with the return 
authorization number to DCA. DCA will not 
accept diskettes which have been sent C.O.D. or 
that do not include a return authorization number. 


Replacement diskettes will be shipped to Purchaser 
by a method of DCA’s choosing to any United 
States destination. If Purchaser desires a specific 
form of conveyance, or is located outside the USA, 
Purchaser must bear the cost of shipment. 


The Purchaser’s sale and exclusive remedy in the 
event of a defect is expressly limited to 
replacement of the diskette. Purchaser shall be 
solely responsible for the failure of any diskette 
resulting from accident, abuse or misapplication of 
the diskette and DCA assumes no liability as a 
consequence of such events under the terms of this 
Limited Warranty. 


Any direct, incidental or consequential damages, 
such as, but not limited to, loss of anticipated 
profits or benefits, caused by malfunction, defect 
or otherwise and with respect to breach of any 


CS-5 


Customer Support Information 





express or implied warranty are not the 
responsibility of DCA or anyone else who has been 
involved in the design, production or delivery of 
the diskette on which the Program is recorded and 
to the extent permitted by law, are hereby 
excluded both for property and to the extent not 
unconscionable, personal injury damage. 


This Limited Warranty gives Purchaser specific 
legal rights, and Purchaser may also have other 
rights which vary from state to state. 


Return For Repair Procedure 
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If a hardware unit proves to be defective, you may 
return it to DCA for repair or replacement. Note 
that proof of date of purchase must accompany all 
products returned for repair that are still under 
warranty. 


Before returning any units, contact DCA’s 
Customer Support. Customer Support will attempt 
to determine the cause of your difficulty. If the 
board requires repair or replacement, they will 
provide a Return Authorization Number (RA#). 
There will be no charge for the replacement or 
repair of boards still under warranty. 


The following explains the procedure for returning 
a unit to DCA. 


l. 


If possible, pack the unit in its original container. 
If the original container is not available, wrap the 
unit in NON-STATIC material such as newspaper 
and pack it ina sturdy, cardboard container. Send 
only the unit. Do NOT send any accessories or 
documentation. 


Include the following information for all units 
returned: 


areas 2 a 


ae 


ban} 
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NAME 

ADDRESS 

CITY, STATE ZIP 
TELEPHONE NUMBER 
RETURN AUTHORIZATION # 
PROBLEM DESCRIPTION 


CF All units should be returned by prepaid postage. 
DCA WILL NOT ACCEPT UNITS THAT HAVE 
BEEN SENT C.O.D. 


4, Mail package to: 


Digital Communications Associates, Inc. 
Attention: Warranty/Repair 

1000 Alderman Drive 

Alpharetta, Georgia 30201-4199 


Write the RA# on the label of your package. 


Any package received without an RA # on the label 
may be returned to you unopened. 


Statement of Copyright Restrictions 


The Digital Communications Associates, Inc. ("DCA") 
user’s guide and software you have purchased is 
copyrighted by DCA and all rights are reserved. 
Your rights of ownership are limited and restricted 
by the copyright laws of the United States. 


It is against the law to copy or in any way reproduce 
or translate any part of this guide without the 
express written permission of DCA. 


It is against the law to copy, reproduce, or transmit 


(including, without limitation, electronic transmission 
over any network) any part of the software except as 
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permitted by the copyright act of the United States 
(Title 17, United States Code). You may write the 
program into the memory of the computer for 
execution. You may make a working copy of the 
software subject to the following restrictions: 1) 
each working copy must be given the same copyright 
protection as the original copy purchased from DCA; 
2) if you ever sell or give away the original copy of 
the software, all working copies must also be sold or 
given to the same person, or destroyed; and 3) no 
copy (original or working) may be used while any 
other copy (original or working) is in use. 


This is not a full statement of copyright laws. For a 
complete statement of the restrictions imposed on you 
under the copyright laws of the United States, see 
Title 17, United States Code. 


For additional information about DCA licensing, see 


the LICENSE AGREEMENT enclosed with the 
distribution diskettes. 
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Addendum 
For 
IRMA 3279 Graphics 


Micro Channel Hardware and Software Installation 


READ THIS SECTION FIRST 


Part Number: 001199 


Introduction 


This addendum documents the installation of IRMA 
3279 Graphics-mca into an IBM Personal System/2 
Model 50, 60, or 80. In addition, the second section 
of this document explains how to install the software 
using version 1.23 or higher of IRMA 3279 Graphics 
software onto an IBM PC or PS/2 system. 


Using the IRMA 3279 Graphics Micro 
Channel Card 





The IRMA 3279 Graphics micro channel card is 
designed for the IBM’s Personal System/2 Models 50, 
60, and 80. The information on the following pages 
will guide you in installing the IRMA 3279 Graphics 
micro channel hardware. 


Prior to the installation, you should have a thorough 
understanding of the functions of the Reference 
Diskette, which is provided with your PS/2. Before 
beginning, review your IBM documentation for 
information on the following areas: 


What is the Reference Diskette? 
How to start the reference diskette 
How to install the IBM options 
How to install an adapter 


You can find these topics in the JBM Personal 
Systems/2 Model 50/60 Quick Reference and the IBM 
Personal System/2 Model 80 Quick Reference manuals. 
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Installing Your IRMA 3279 Graphics Micro 
Channel Card 


Installing the IRMA 3279 Graphics micro channel 
hardware requires you to do the following: 


1. Create a backup of the IBM PS/2 Reference 
Diskette. 


2. Transfer the Adapter Definition File 
(@6E78.adf) from the IRMA 3279 Graphics 
program diskette to the backed up Reference 
Diskette. 


3. Install the IRMA 3279 Graphics micro channel 
card. 


4. Update the PS/2 hardware configuration. 


Creating a Backup of the IBM PS/2 
Reference Diskette 


The following steps tell you how to create a backup 
copy of the IBM Personal System/2 Model 50/60 
Reference Diskette or the IBM Personal System/2 
Model 80 Reference Diskette. If you already have 
successfully create a backup diskette, proceed to the 
next section on transferring the adapter definition 
file, @6E78.adf. 


Before you begin, make sure you have the following: 


m The original PS/2 Reference Diskette 
= A 3.5" blank HD (high density - 1.4 Meg) diskette 
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Making the Backup Copy 





1. Insert the original Reference Diskette in drive A 
of the PS/2 Model 50, 60 or 80 and turn on the 
unit. 


2. Wait for the memory count and single beep 
signal. When the IBM Reference Diskette logo 
screen appears, press <Enter> to continue. 


3. Select item 2 (Backup the Reference Diskette) 
from the Main Menu. Follow the prompts in the 
Instruction window. Note that IBM refers to the 
backup copy as the "target" diskette. 


4. This process will format your diskette and ask 
you several times to change the backup and the 
original diskette while reading data and copying 
information onto the backup diskette. 


5. When the "Copy Complete" message appears in 
the Information window, press <Enter>. At the 
Main Menu, press <Esc> to quit. 


6. Follow the Information window instructions to 


restart your system. 


Transferring the Adapter Definition File to the 
Backup Reference Diskette 





This section explains how to modify the backup 
Reference Diskette to install and support the 
required configuration information for the IRMA 
3279 Graphics micro channel card. The @6E78.adf 
adapter definition file contains load addresses, 
interrupts, and other pertinent information about the 
IRMA 3279 Graphics micro channel card that the 
PS/2 requires to configure the Micro Channel Bus. 





Addendum for IRMA 3279 Graphics 





Before you begin, make sure you have the following: 


«= A backup PS/2 Model 50 and 60 Reference 
Diskette or a backup PS/2 Model 80 Reference 
Diskette | 

= The IRMA 3279 Graphics program diskette 
which contains the @6E78.adf file 


Procedures 


STEP 1: 


STEP 2: 


STEP 3: 


STEP 4: 


STEP 5: 





Restart your system unit with the backup 
Reference Diskette in drive A. Following 
the memory count and a single beep, the 
IBM Reference Diskette logo screen 
appears. Press <Enter> to continue. 


Select item 5 (Copy an option diskette). 
Note that when the PS/2 prompts you for 
"New Option Diskette", it expects a disk 
containing a *.ADF file, such as the 
@6E78.adf file contained on your IRMA 
3279 Graphics program diskette. Follow 
the instructions in the Information 
window. 


The PS/2 unit checks the @6E78.adf 
adapter definition file and reads the 
information into memory. It then asks 
you to insert your backup Reference 
Diskette in drive A. Note that IBM refers 
to it as the "copy of the Product 2 


Diskette". 


When the update of the backup Reference 
Diskette is completed, press <Enter>. 


At the Main menu, press <Esc> to quit. 
Then, follow the instructions in the 
Information window to restart your 
system. 
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Installing the IRMA 3279 Graphics Micro 
Channel Card 





Before you begin, make sure you have the following: 
# an IRMA 3279 Graphics micro channel card 


= acoin | 
* accopy of your system’s IBM quick reference 
manual 


Prior to installing the IRMA 3279 Graphics micro 
channel card, you should have a thorough 
understanding of the PS/2 Reference Diskette and 
the adapter installation procedures as described in 
your system’s documentation. 


The adapter installation procedures are explained in 
the [BM Personal System/2 Quick Reference Manual. 
See also the [BM Personal System/2 Model 50 and 60 
Quick Reference manual and the [BM Personal 
System/2 Model 80 Quick Reference manual. In 

- particular, refer to: 


= “Removing the System Unit Cover" 
# "Installing an Adapter" 
= "Installing the System Unit Cover" 
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Slot Selection 





The IRMA 3279 Graphics micro channel card must 
be installed into a siot that connects all connectors 
on the bottom of the card. The following lists the 
correct slots: 


Model 50 - slot 2 
Model 60 - slot 2 
Model 80 - slot 2 


Please make sure that the coax connector plate is 


flush with the expansion slot cover that you removed 
from the system unit. 


Updating the PS/2 Hardware Configuration 





After you install the hardware and reconnect the 
devices and power supply to your system unit, you 
must update the PS/2 configuration. This final step 
is required to complete the hardware installation. 


Before you begin, make sure you have the following: 


= Updated Reference Diskette with the @6E78.ADF 
file | 


How to Update the PS/2 Configuration 





STEP 1: -Insert the backup Reference Diskette in 
drive A and turn on your PS/2. 


STEP 2: After the memory count, the PS/2 
displays the message, ERROR 165, and 
issues two short beeps which are followed 
by the appearance of the IBM Reference 





STEP 3: 
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Diskette logo screen. Press <Enter> to 
continue. 


The system displays a brief description of 
the error resulting from the addition of 
the IRMA 3279 Graphics hardware. Press 
<PgDn> to proceed to the next screen, 
which gives you a choice of either 
automatically or manually configuring the 
system. 


Automatic Configuration 





STEP !: 


STEP 2: 


STEP 3: 


If you want to configure the system 
automatically, press <Y> for "yes". The 
Information window will inform you that 
automatic configuration is under way. 
After you receive the completion message, 
press <Enter> to restart the computer. 


Automatic configuration selects the IRMA 
3279 Graphics hardware default I/O 
address range of 220-22Fh/280/29Fh. 
IRMA 3279 Graphics reads and writes to 
these addresses which support software 
written for IRMA 3279 Graphics, IRMA, 
IRMA 2, and PJ. However, only one base 
address is used at a time. 


‘NOTE: If you need to change I/O 


addresses, refer to the section on 
changing the IRMA 3279, 
Graphics I/O address. 


After restarting, the PS/2 should complete 
its Memory count without returning any 
error messages, issue a single beep, and 
display the DOS prompt. This sequence 
of events follows if you have successfully 
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installed the IRMA 3279 Graphics 
hardware. 


Manual Configuration 





STEP 1: If you want to reconfigure the system 
manually, press <N> for "no". Next, from 
the Main Menu of the backup Reference 
Diskette, select item 3 (Set Configuration). 


STEP 2: From the Set Configuration Menu, select 
item | (View Configuration). Press 
<PgDn> to see which adapters are 
installed and what their PS/2 slot 
locations are. IRMA 3279 Graphics 
should be displayed as having an I/O 
address range of 220-22Fh/280-29Fh and 
being in the numbered slot in which it 
was installed. 


STEP 3: Press <Esc> to return to the Set 
Configuration menu. 


NOTE: If you need to change these I/O 
addresses, refer to the section on 
changing the IRMA 3279 
Graphics I/O address. 


STEP 4: Select item 3 (Backup configuration). 
Press <Enter> when the "Backup 
Complete" message appears in the 
Information window. 


STEP 5: Quit the Set Configuration Menu by 
pressing <Esc>. At the Main Menu, press 
<Esc> again. Follow the instructions in 
the Information window to restart your 
System. 





STEP 6: 
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After restarting, the PS/2 should complete 
its memory count without returning any 
error messages, issue a single beep, and 
display the DOS prompt. This sequence 
of events follows if you have successfully 
installed the IRMA 3279 Graphics card. 


Changing the IRMA 3279 Graphics Base I/O 


Address 





STEP |: 


STEP 2: 


STEP 3: 


STEP 4: 


Perform step | in the previous section on 
manual configuration. 


From the Set Configuration Menu, select 
item 2, (Change Configuration). Use the 
<PgDn> key to move down the 
configuration screen to the slot entry for 
the IRMA 3279 Graphics card. (The 
default settings for the I/O address range 
will be displayed as 220-22Fh/280-29Fh.) 


Press <F6> (Next Value), as directed by 
the screen prompts, to display the next 
address range which 1s 280-29Fh. Other 
addresses available include the range of 
2C0-2Dfh, A80-A9Fh, and Ac0-Adfh. 
Press <F6> to scroll through the settings 
or <F5> to return to a previous choice. 


Press <F10> to save the setting you 
selected, and wait for the PS/2 to display 
the message, "Save configuration 
complete". Continue with steps 5 and 6 
covered in the previous section, Manual 
Configuration, to complete the procedure. 
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Installing IRMA 3279 Graphics on an IBM 
PS/2 


Once you complete the hardware and system 
configuration steps, you can install the IRMA 3279 
Graphics software by following the software 
installation instructions in the next section of this 
addendum. Follow the steps given for a hard disk 
system. 


Software Installation for the IBM PC and 
PS/2 Systems 
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Before you can use your PC as a 3279 S3G terminal, 
you must install the software and run the GraphPac 
configuration program. Chapter 2 of the IRMA 3279 
Graphics User’s Guide provides detailed information 
on the GraphPac configuration program. This 
section guides you through an automated process that 
installs the software, and it shows you how to set up 
the CONFIG.SYS file. 


The software includes two keyboard drivers, 
KYBDDRV.SYS and KMACDRVSSYS, which support 
such options as keyboard macros, alternate keyboard 
profiles, international keyboard profiles and certain 
types of non-standard PC hardware. The keyboard 
driver, KYBDDRV.SYS, must be installed to use the 
IRMA 3279 Graphics software. The macro driver, 
KMACDRVSSYS, is optional. Installation procedures 
for both keyboard drivers are given in this 
addendum. 


Chapter 2 of the [RMA 3279 Graphics User’s Guide 
provides detailed information on keyboard drivers. 
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Steps to Install and Configure the IRMA 3279 
Graphics Software 


STEP 1: Run the DCA install program. 
STEP 2: Configure the software using GraphPac 
STEP 3: Create or modify a CONFIGSYS file. 


NOTE: International users only must 
execute STEP 4. 


STEP 4: Create or modify an AUTOEXEC.BAT 
file. 


Installing the Software 


This section guides you through the process for 
installing the software to a floppy diskette and a 
hard disk. 


Before you begin, make backup copies of the IRMA 
3279 Graphics diskettes. Use the backup diskettes 
for installing and configuring the software. 


If you are installing the software onto a floppy 
diskette you will need one formatted diskette with 
DOS on it, on which to install the software. Follow 
these steps to complete the installation. 


STEP 1: Place any of the IRMA 3279 Graphics 
diskettes into drive A. 


STEP 2: Make your current working directory 
drive A. 


STEP 3: At the A prompt type: 


DCA <Enter> 
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The software displays instructions for installing the 
software for several types of environments. Read 
through the instructions and follow the prompts 
according to your environment. The following 
outlines the appropriate actions for each step. 


The default settings to the prompts appear in 
brackets. 


1) If you are a domestic (U‘S.) user, insert the 
Keyboard and Printer Utilities Diskette into 
drive A. 


If you are an international user, insert the 
Keyboard Profiles Diskette. 


2) At select target drive: 
For floppy diskette installation, type B 
or 
For hard diskette installation, type C 


NOTE: Hard disk installation will automatically 
create a DCA directory to which it installs 
the software. Make sure you do not have an 
existing DCA directory. 


If you are installing the software onto a 
floppy diskette make sure you have a 
bootable floppy in Drive B. 


3) At Select Printer, you may select a printer or 
you may wait to configure the printer in the 
GraphPac configuration program. There are 
many more printer options in GraphPac than in 
the install program. 


4) At Select National Language, pick the 
appropriate language for your environment. 
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For domestic (U.S.) users press <Enter>. 


The program will then prompt you for the current 
diskette to insert into drive A. The program will 
automatically copy the appropriate files to your 
floppy diskette or hard disk. 


Configuring the Software using GraphPac 


After the program has finished the installation 
process, it will automatically invoke the GraphPac 
program. To complete the installation process, use 
the GraphPac program to configure the software for 
your environment. 


YOU MUST CONFIGURE THE SOFTWARE FOR 
YOUR SPECIFIC ENVIRONMENT USING 
GraphPac IN ORDER TO USE THE IRMA 3279 
GRAPHICS SOFTWARE. 


Refer to the section on IRMA 3279 Graphics and the 
VGA in this addendum to configure the emulation 
software for an IBM PS/2 Model 50, 60, or 80. The 
GraphPac program is fully documented in Chapter 2 
of the [IRMA 3279 Graphics User’s Guide. 


Creating a CONFIG.SYS File 


Floppy Diskette Users: 


Create a CONFIGSSYS file on the working copy of 
the IRMA 3279 Graphics diskette to contain the 
keyboard drivers. Type the following command at 
the DOS A> prompt: 


COPY CON CONFIG.SYS <Enter> 
DEVICE=KYBDDRV.SYS -2go[x] <Enter> 
DEVICE=KMACDRV.SYS <Enter> 

<F6> <Enter> 
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The -2 in the second line allows space in memory for 
two keyboard profiles. You can allow memory for 
up to 9 keyboard profiles. 


The g and o switches exist for compatibility with 
certain DOS applications. 


The x option represents one or all of the remaining 
keyboard driver options. The </RMA 3279 Graphics 
User’s Guide outlines these options. 


NOTE: International users must add an N switch. 


Reboot the PC with a working copy of the IRMA 
3279 Graphics diskette to load the keyboard drivers. 


Refer to the section on IRMA 3279 Graphics and the 
VGA in this addendum to configure the emulation | 
software for an IBM PS/2 Model 50, 60, or 80. The 
GraphPac program is fully documented in Chapter 2 
of the IRMA 3279 Graphics User's Guide. 


Hard Disk Users: 


Create or modify a CONFIGSYS on the hard disk 
root directory to contain the following: 


DEVICE=KYBDDRV.SYS -2go[x] <Enter> 
DEVICE=KMACDRV.SYS <Enter> 


The g and o switches exist for compatibility with 
certain DOS applications. 


The x option represents one or all of the remaining 
keyboard driver options. Chapter 2 in the [RMA 
3279 Graphics User’s Guide outlines these options. 


NOTE: International users must add an N switch. 





Next copy the KYBDDRV.SYS and KMACDRV.SYS 
files from the DCA directory to the root directory. 
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Reboot the PC to load the keyboard drivers. 


Refer to the section on IRMA 3279 Graphics and the 
VGA in this addendum to configure the emulation 
software for an IBM PS/2 Model 50, 60, or 80. The 
GraphPac program is fully documented in Chapter 2 
of the [RMA 3279 Graphics User’s Guide. 


International Users 


International users must also create or modify an 
AUTOEXEC.BAT file to load the DOS keyboard 
profile. Hard disk users must include the 
AUTOEXEC.BAT file on their root directories with 
a DOS path to the DCA directory where the IRMA 
3279 Graphics software is installed. Floppy users - 
must include the AUTOEXEC.BAT on their bootable 
working copy of the IRMA 3279 Graphics software. 


Create or modify an AUTOEXEC.BAT file to 
include the following: 


K YBDLOAD/s=2/a KEYB**.K YB 
The a switch automatically activates the DOS profile. 


The ** in the KEYB file name represents the codes 
given to the various countries. These codes are: 


BE = Belgian NS = New Spanish 

CA = Canadian French SF = Swiss-French 

FC = Canadian Bilingual SG = Swiss-German 

FI = Finnish SP = Spanish 

FR = French Azerty-105 SS. = Spanish Speaking 
GR = German SW = Swedish 

IT = Italian UK = English 

NO = Norwegian 
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IRMA 3279 Graphics and the VGA 
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IRMA 3279 Graphics recognizes the PS/2’s VGA 
(Video Graphics Array) as a compatible display 
adapter. The following instructions detail how to 
configure the emulator for VGA support. 


STEP I: 


STEP 2: 
STEP 3: 
STEP 4: 
STEP 5: 


STEP 6: 


STEP 7: 


STEP 8: 


To install the VGA, go to your GraphPac 
main menu by typing in <GP> at the DOS 
prompt. 


Choose item 3 (Configuration). 
Choose item 3 (Configure Video). 
Choose item | (Configure monitor). 


Choose item 14 (IBM 5512, 5513 PS/2 
Color) 


or 


Choose item 15 (IBM 8503 PS/2 
Monochrome). 


Press <Esc> until you return to the main 
menu. 


At this time, you may continue the 
configuration for any additional item you 
may need. (See the [RMA 3279 Graphics 
User’s Guide for full instructions on 


GraphPac.) 


Press <Esc> until you are back to the DOS 
prompt. 


To execute the IRMA 3279 Graphics emulation 


program, follow the instructions in the [RMA 3279 
Graphics User's Guide. 
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Diagnostics 





Appendix E in the IRMA 3279 Graphics User’s 
Guide documents the CHK BD program for hardware 
diagnostics. Software version 1.23 or higher contains 
two CHKBD programs located in subdirectories on 
the master IRMA 3279 Graphics program diskette. 


One CHKBD program is for the standard IRMA 3279 
Graphics hardware and is located in subdirectory 
2BOARD. The other CHK BD program is for the 
IRMA 3279 Graphics upgrade and is located in the 
subdirectory 3BOARD. 


To use these programs according to the 
documentation in Appendix E, copy all of the files 
in the correct directory for your environment 
(depending on whether you have the standard or 
upgrade product) onto your hard disk or floppy. 


17 


IRMA 3279 Graphics 


User’s Guide 





Part #:40-97910-036 


Digital Communications Associates, Inc. ("DCA"), 
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information contained herein is the property of 
DCA and shall not be copied, photocopied, 
translated or reduced to any electronic or machine 
readable form, in whole or in part, without prior 
written approval from DCA. 


DCA reserves the right to, without notice, modify 
or revise all or part of this document and/or 
change product features or specifications and shall 
not be responsible for any loss, cost, or damage, 
including consequential damage, caused by reliance 
on these materials. 


In all correspondence with Digital Communications 
Associates, Inc. regarding this publication, refer to 
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Copyright (C) 1987 by Digital Communications 
Associates, Inc., 1000 Alderman Drive, Alpharetta, 
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